Skip to main content

Connect your agent

Connect in three steps

1

Create a Developer API key

Sign in and open Settings → API & MCP. Create a dedicated key for your assistant: choose Read & write to list, create, update, and delete subscriptions, or Read only for safe querying and spend analysis. The full subm_… secret is shown only once and never expires automatically until revoked.
2

Copy to Agent (or copy a manual client snippet)

Choose MCP · recommended or API only, then click Copy to Agent. By default the generated prompt contains no secret; right after creating a key, you can optionally check Include newly created key in this copy for a trusted agent. Prefer manual configuration? Expand Manual client config on the same card for ready-to-paste snippets for Claude Code, Claude Desktop, Cursor, and Codex.
3

Verify the connection

Ask the agent to list your subscriptions (it will verify access with a read-only query without creating test data; an empty list also counts as success). You can also click Test API connection directly inside Settings → API & MCP to verify any new or saved key—testing updates the key’s Last used timestamp immediately.
After connecting, try natural prompts like:
  • “Which subscriptions or free trials renew in the next 14 days?”
  • “Summarize my monthly spend by currency and category.”
  • “Add ChatGPT Plus at $20/month renewing on 2026-07-17.” (With a write key, the agent summarizes and asks for confirmation first.)
  • “Delete the duplicate Netflix tracking entry.” (With a write key, the agent confirms exact name and id first.)

Choose how to connect

[!TIP] Download MCP on Settings → API & MCP also provides a backwards-compatible standalone npm tarball (/downloads/subscription-manager-mcp.tgz). For most local stdio setups, downloading /downloads/steadyrenew-mcp.mjs directly (curl -fsSL https://steadyrenew.com/downloads/steadyrenew-mcp.mjs -o ~/.steadyrenew/mcp/steadyrenew-mcp.mjs) is faster and avoids npm workspace install quirks.

Plan limits & scope behavior

  • Rate & key limits: Both Free and Premium accounts allow up to 5 active keys and 60 requests / minute per account (shared across keys). Keys never expire automatically.
  • Read-only keys: Selecting Read only generates a ["read"] key and tailors Copy to Agent so the assistant knows upfront not to attempt writes.
  • Premium analytics: get_spend_summary works on all plans; find_duplicate_subscriptions and get_optimization_suggestions require Lifetime Premium (403 premium_required on Free).
  • Web-only settings: Deleting a record never cancels a subscription with the external merchant. Bark push URLs, test pushes, timeZone, locale, and category catalog edits stay in the web app (see Reminders).

Troubleshooting

Machine-readable entry points

Hosted on the application origin (https://steadyrenew.com in production):
  • /api/mcp — Stateless Streamable HTTP MCP endpoint (POST with Bearer subm_…).
  • /downloads/steadyrenew-mcp.mjs — Zero-dependency single-file local stdio MCP server.
  • /downloads/subscription-manager-mcp.tgz — Standalone npm tarball MCP package.
  • /agent/setup.md — Step-by-step agent onboarding & client configuration reference.
  • /agent/ai-tools.json — Canonical 11-tool JSON schema with risk & confirmation metadata.
  • /agent/openapi.yaml — OpenAPI 3.1 specification for /api/v1/*.