Home / Servers / Stripe API / post_subscription_schedules

Create a schedule

An MCP tool from the Stripe API server, hosted on mcp.hjlabs.in.

Create a schedule Creates a new subscription schedule object. Each customer can have up to 500 active or scheduled subscriptions. [POST /v1/subscription_schedules]

Name on the gateway: stripe_api__post_subscription_schedules · may change things.

Parameters

NameTypeDescription
billing_modeobjectControls how prorations and invoices for subscriptions are calculated and…
customerstringThe identifier of the customer to create the subscription schedule for.
customer_accountstringThe identifier of the account to create the subscription schedule for.
default_settingsobjectObject representing the subscription schedule's default settings.
end_behaviorcancel | none | release | renewBehavior of the subscription schedule and underlying subscription when it…
expandarraySpecifies which fields in the response should be expanded.
from_subscriptionstringMigrate an existing subscription to be managed by a subscription schedule. If…
metadataobjectSet of key-value pairs that you can attach to an object. This can be useful…
pause_schedulesarrayConfigures the subscription's pause behavior and, optionally, its resume…
phasesarrayList representing phases of the subscription schedule. Each phase can be…
start_dateintegerWhen the subscription schedule starts. We recommend using now so that it…

How to call it

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments
{
  "name": "stripe_api__post_subscription_schedules",
  "arguments": {}
}

Or connect the Stripe API server directly, which lists 606 tools including this one:

Run in your terminal
claude mcp add --transport http hj-stripe-api https://mcp.hjlabs.in/mcp/stripe-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Try asking

Use the create a schedule tool with billing_mode set to ….

More from Stripe API