Home / Servers / Stripe API / post_subscription_items
Create a subscription item
An MCP tool from the Stripe API server, hosted on mcp.hjlabs.in.
Create a subscription item Adds a new item to an existing subscription. No existing items will be changed or replaced. [POST /v1/subscription_items]
Name on the gateway: stripe_api__post_subscription_items · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
billing_thresholds | object | Define thresholds at which an invoice will be sent, and the subscription… |
current_trial | object | The trial offer to apply to this subscription item. |
discounts | array | The coupons to redeem into discounts for the subscription item. |
expand | array | Specifies which fields in the response should be expanded. |
metadata | object | Set of key-value pairs that you can attach to an object. This can be useful… |
payment_behavior | allow_incomplete | default_incomplete | error_if_incomplete | pending_if_incomplete | Controls how Stripe handles payment when a subscription update requires… |
price | string | The ID of the price object. |
price_data | object | Data used to generate a new Price object inline. |
proration_behavior | always_invoice | create_prorations | none | Determines how to handle prorations when the billing cycle changes (e.g., when… |
proration_date | integer | If set, the proration will be calculated as though the subscription was… |
quantity | integer | The quantity you'd like to apply to the subscription item you're creating. |
subscription required | string | The identifier of the subscription to modify. |
tax_rates | array | A list of Tax Rate ids. These Tax Rates will override the default_tax_rates on… |
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:
{
"name": "stripe_api__post_subscription_items",
"arguments": {
"subscription": "…"
}
}Or connect the Stripe API server directly, which lists 606 tools including this one:
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 subscription item tool with billing_thresholds set to ….