Home / Servers / Stripe API / post_customers_customer_subscriptions_subscription_exposed_i
Update a subscription on a customer
An MCP tool from the Stripe API server, hosted on mcp.hjlabs.in.
Update a subscription on a customer Updates an existing subscription on a customer to match the specified parameters. When changing plans or quantities, we will optionally prorate the price we charge next month to make up for any… [POST /v1/customers/{customer}/subscriptions/{subscription_exposed_id}]
Name on the gateway: stripe_api__post_customers_customer_subscriptions_subscription_exposed_i · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
customer required | string | customer parameter |
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 | now | unchanged | Either now or unchanged. Setting the value to now resets the subscription's… |
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… |
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… |
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_customers_customer_subscriptions_subscription_exposed_i",
"arguments": {
"customer": "…",
"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 on a customer tool with customer set to ….