Home / Servers / Stripe API / post_subscriptions_subscription_exposed_id
Update a subscription
An MCP tool from the Stripe API server, hosted on mcp.hjlabs.in.
Update a subscription Updates an existing subscription to match the specified parameters. When changing prices or quantities, we optionally prorate the price we charge next month to make up for any price changes. To… [POST /v1/subscriptions/{subscription_exposed_id}]
Name on the gateway: stripe_api__post_subscriptions_subscription_exposed_id · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
subscription_exposed_id required | string | subscription_exposed_id parameter |
add_invoice_items | array | A list of prices and quantities that will generate invoice items appended to… |
application_fee_percent | number | A non-negative decimal between 0 and 100, with at most two decimal places.… |
automatic_tax | object | Automatic tax settings for this subscription. We recommend you only include… |
billing_cycle_anchor | object | Controls how the subscription's billing cycle anchor changes. Set type to now… |
billing_schedules | array | An array of billing schedules, which allow you to bill customers in advance… |
billing_thresholds | object | Define thresholds at which an invoice will be sent, and the subscription… |
cancel_at | integer | A timestamp at which the subscription should cancel. If set to a date before… |
cancel_at_period_end | boolean | Indicate whether this subscription should cancel at the end of the current… |
cancellation_details | object | Details about why this subscription was cancelled |
collection_method | charge_automatically | send_invoice | Either charge_automatically, or send_invoice. When charging automatically… |
days_until_due | integer | Number of days a customer has to pay invoices generated by this subscription.… |
default_payment_method | string | ID of the default payment method for the subscription. It must belong to the… |
default_source | string | ID of the default payment source for the subscription. It must belong to the… |
default_tax_rates | array | The tax rates that will apply to any subscription item that does not have… |
description | string | The subscription's description, meant to be displayable to the customer. Use… |
discounts | array | The coupons to redeem into discounts for the subscription. A populated array… |
expand | array | Specifies which fields in the response should be expanded. |
invoice_settings | object | All invoices will be billed using the specified settings. |
items | array | A list of up to 20 subscription items, each with an attached price. |
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… |
on_behalf_of | string | The account on behalf of which to charge, for each of the subscription's… |
pause_collection | object | If specified, payment collection for this subscription will be paused. Note… |
payment_behavior | allow_incomplete | default_incomplete | error_if_incomplete | pending_if_incomplete | Controls how Stripe handles payment when a subscription update requires… |
payment_settings | object | Payment settings to pass to invoices created by the subscription. |
pending_invoice_item_interval | object | Specifies an interval for how often to bill for any pending invoice items. It… |
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, prorations will be calculated as though the subscription was updated… |
transfer_data | object | If specified, the funds from the subscription's invoices will be transferred… |
trial_end | now | Unix timestamp representing the end of the trial period the customer will get… |
trial_from_plan | boolean | Indicates if a plan's trial_period_days should be applied to the subscription.… |
trial_settings | object | Settings related to subscription trials. |
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_subscriptions_subscription_exposed_id",
"arguments": {
"subscription_exposed_id": "…"
}
}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 tool with subscription_exposed_id set to ….