Home / Servers / Stripe API / post_subscription_items_item
Update a subscription item
An MCP tool from the Stripe API server, hosted on mcp.hjlabs.in.
Update a subscription item Updates the plan or quantity of an item on a current subscription. [POST /v1/subscription_items/{item}]
Name on the gateway: stripe_api__post_subscription_items_item · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
item required | string | item parameter |
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… |
off_session | boolean | Indicates if a customer is on or off-session while an invoice payment is… |
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. You can use either price or price_data, but not… |
price_data | object | Data used to generate a new Price object inline. You can use either price or… |
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. |
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_item",
"arguments": {
"item": "…"
}
}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 update a subscription item tool with item set to ….