Home / Servers / Stripe API / post_plans

Create a plan

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

Create a plan You can now model subscriptions more flexibly using the Prices API . It replaces the Plans API and is backwards compatible to simplify your migration. [POST /v1/plans]

Name on the gateway: stripe_api__post_plans · may change things.

Parameters

NameTypeDescription
activebooleanWhether the plan is currently available for new subscriptions. Defaults to true.
amountintegerA positive integer in cents (or local equivalent) (or 0 for a free plan)…
amount_decimalstringSame as amount, but accepts a decimal value with at most 12 decimal places.…
billing_schemeper_unit | tieredDescribes how to compute the price per period. Either per_unit or tiered.…
currency requiredstringThree-letter ISO currency code, in lowercase. Must be a supported currency.
expandarraySpecifies which fields in the response should be expanded.
idstringAn identifier randomly generated by Stripe. Used to identify this plan when…
interval requiredday | month | week | yearSpecifies billing frequency. Either day, week, month or year.
interval_countintegerThe number of intervals between subscription billings. For example…
metadataobjectSet of key-value pairs that you can attach to an object. This can be useful…
meterstringThe meter tracking the usage of a metered price
nicknamestringA brief description of the plan, hidden from customers.
productobjectThe product whose pricing the created plan will represent. This can either be…
tiersarrayEach element represents a pricing tier. This parameter requires billing_scheme…
tiers_modegraduated | volumeDefines if the tiering price should be graduated or volume based. In…
transform_usageobjectApply a transformation to the reported usage or set quantity before computing…
trial_period_daysintegerDefault number of trial days when subscribing a customer to this plan using…
usage_typelicensed | meteredConfigures how the quantity per period should be determined. Can be either…

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_plans",
  "arguments": {
    "currency": "…",
    "interval": "…"
  }
}

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 plan tool with active set to ….

More from Stripe API