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.
Recommended agent policy
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:- Calls
list_subscriptions. - Finds the Netflix record.
- Asks:
- Calls
update_subscriptiononly after confirmation:
Error recovery
Errors use a stable shape:- Validation hints (
400): Usefield,suggestedFix,allowedValues, andwritableFieldsto 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 withwritescope is required. - Premium analytics (
403 premium_required): Do not retryfind_duplicate_subscriptionsorget_optimization_suggestions; explain that those two tools require Lifetime Premium (https://steadyrenew.com/pricing), or fall back tolist_subscriptions/get_spend_summary.