Skip to main content

AI tool usage

For guided client setup, start with Connect your agent. Under Settings → API & MCP, the Copy to Agent button generates an onboarding prompt with your site origin, remote Streamable HTTP MCP endpoint (/api/mcp), single-file local MCP download (/downloads/steadyrenew-mcp.mjs), and API contract links. If you are integrating a custom agent framework directly, use the AI tool schema for JSON tool definitions or the OpenAPI schema for OpenAPI-based tool importers. Give the assistant this policy before allowing write access:

All 11 tools & selection guide

Risk levels

The public API does not support soft cancel/pause/resume via status. If the user asks to cancel a subscription, clarify whether they mean deleting the local tracking record or cancelling the service with the external provider. Bark URL, test push, timeZone, and locale cannot be read or written through the public API; point the user to the web app and the reminders guide.

Example flow

User:
Assistant:
  1. Calls list_subscriptions.
  2. Finds the Netflix record.
  3. Asks:
  1. Calls update_subscription only after confirmation:

Error recovery

Errors use a stable shape:
  • Validation hints (400): Use field, suggestedFix, allowedValues, and writableFields to fix the payload. Ask for confirmation again if the corrected payload changes the effective action.
  • Read-only key (403 insufficient_scope): Do not retry; explain that a key with write scope is required.
  • Premium analytics (403 premium_required): Do not retry find_duplicate_subscriptions or get_optimization_suggestions; explain that those two tools require Lifetime Premium (https://steadyrenew.com/pricing), or fall back to list_subscriptions / get_spend_summary.