Home / Servers / Stripe API / post_subscriptions
Create a subscription
An MCP tool from the Stripe API server, hosted on mcp.hjlabs.in.
Create a subscription Creates a new subscription on an existing customer. Each customer can have up to 500 active or scheduled subscriptions. When you create a subscription with collection_method=charge_automatically… [POST /v1/subscriptions]
Name on the gateway: stripe_api__post_subscriptions · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
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. |
backdate_start_date | integer | A past timestamp to backdate the subscription's start date to. If set, the… |
billing_cycle_anchor | integer | A future timestamp in UTC format to anchor the subscription's billing cycle.… |
billing_cycle_anchor_config | object | Mutually exclusive with billing_cycle_anchor and only valid with monthly and… |
billing_mode | object | Controls how prorations and invoices for subscriptions are calculated and… |
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… |
collection_method | charge_automatically | send_invoice | Either charge_automatically, or send_invoice. When charging automatically… |
currency | string | Three-letter ISO currency code, in lowercase. Must be a supported currency. |
customer | string | The identifier of the customer to subscribe. |
customer_account | string | The identifier of the account representing the customer to subscribe. |
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. If not specified or… |
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… |
payment_behavior | allow_incomplete | default_incomplete | error_if_incomplete | pending_if_incomplete | Controls how Stripe handles the first invoice when payment is required and… |
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 resulting from the billing_cycle_anchor.… |
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_period_days | integer | Integer representing the number of trial period days before the customer is… |
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",
"arguments": {}
}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 tool with add_invoice_items set to ….