Skip to content
Scalekit Docs
Talk to an EngineerDashboard

Stripe MCP

Vendor MCP28 toolsOAuth 2.1/DCRAccounting & FinanceAutomation

Connect to Stripe MCP. Manage customers, invoices, subscriptions, refunds, disputes, and payments from your AI workflows.

Stripe MCP connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Authorize and make your first call

    Section titled “Authorize and make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'stripemcp'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Stripe MCP:', link)
    process.stdout.write('Press Enter after authorizing...')
    await new Promise(r => process.stdin.once('data', r))
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'stripemcp_list_available_accounts_or_orgs',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Planner stripe implementation — Stripe payment integration planner
  • Write stripe api — Execute a write (POST/DELETE) Stripe API operation by its operation ID and parameters
  • Read stripe api — Execute a read-only (GET) Stripe API operation by its operation ID and parameters
  • Analytics stripe — Analyze Stripe data (e.g
  • Accounts manage stripe — Returns a URL to the Stripe Dashboard where the user can add accounts, remove accounts, or change permissions for this session
  • List available accounts or orgs — Lists all Stripe accounts available in this session with their stripe_context and livemode values

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

stripemcp_cancel_subscription#[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Immediately cancel an active Stripe subscription. The subscription ends at the current period and no further charges are made. This is irreversible — use Update Subscription to pause or downgrade instead.1 param

[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Immediately cancel an active Stripe subscription. The subscription ends at the current period and no further charges are made. This is irreversible — use Update Subscription to pause or downgrade instead.

NameTypeRequiredDescription
subscriptionstringrequiredID of the subscription to cancel immediately. Cancellation is permanent — the subscription cannot be reactivated.
stripemcp_create_coupon#[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Create a discount coupon that applies a percentage or fixed amount off. Use percent_off for percentage discounts or amount_off+currency for fixed discounts. Set duration to once, forever, or repeating.6 params

[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Create a discount coupon that applies a percentage or fixed amount off. Use percent_off for percentage discounts or amount_off+currency for fixed discounts. Set duration to once, forever, or repeating.

NameTypeRequiredDescription
namestringrequiredInternal name for the coupon shown in the Stripe dashboard and on invoices.
amount_offnumberoptionalFixed discount amount in the smallest currency unit (e.g. 500 = .00 off). Requires currency. Use this or percent_off — not both.
currencystringoptionalRequired when using amount_off. Three-letter ISO currency code matching the discount amount.
durationstringoptionalHow long the coupon applies: once (first invoice only), forever (all invoices), or repeating (for duration_in_months months).
duration_in_monthsnumberoptionalNumber of months the discount applies when duration is repeating.
percent_offnumberoptionalPercentage discount between 0 and 100. Use this or amount_off — not both.
stripemcp_create_customer#[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Create a new Stripe customer record with a name and optional email. Returns the customer ID (cus_...) used in invoices, subscriptions, and payment intents.2 params

[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Create a new Stripe customer record with a name and optional email. Returns the customer ID (cus_...) used in invoices, subscriptions, and payment intents.

NameTypeRequiredDescription
namestringrequiredFull name of the customer as it will appear on invoices and receipts.
emailstringoptionalCustomer email address. Used for receipt delivery and customer lookup.
stripemcp_create_invoice#[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Create a draft invoice for a customer. The invoice starts in draft status — add line items with Create Invoice Item, then call Finalize Invoice to mark it ready for payment.2 params

[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Create a draft invoice for a customer. The invoice starts in draft status — add line items with Create Invoice Item, then call Finalize Invoice to mark it ready for payment.

NameTypeRequiredDescription
customerstringrequiredID of the Stripe customer to bill. Add line items with Create Invoice Item after creating the invoice.
days_until_duenumberoptionalPayment due date expressed as days from today. Used for net-terms invoices (e.g. 30 for net-30). Leave blank for invoices collected immediately.
stripemcp_create_invoice_item#[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Add a line item to an existing draft invoice using a price ID. The invoice must be in draft status. Both the customer and invoice IDs are required to associate the item correctly.3 params

[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Add a line item to an existing draft invoice using a price ID. The invoice must be in draft status. Both the customer and invoice IDs are required to associate the item correctly.

NameTypeRequiredDescription
customerstringrequiredID of the customer the invoice belongs to. Must match the customer on the invoice.
invoicestringrequiredID of the draft invoice to add this line item to. Invoice must be in draft status.
pricestringrequiredID of the price to add as a line item. The price determines amount and currency.
stripemcp_create_price#[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Create a one-time or recurring price for a product. Amounts are in the smallest currency unit (cents for USD). Omit recurring for one-time prices; include it for subscription billing.4 params

[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Create a one-time or recurring price for a product. Amounts are in the smallest currency unit (cents for USD). Omit recurring for one-time prices; include it for subscription billing.

NameTypeRequiredDescription
currencystringrequiredThree-letter ISO 4217 currency code (lowercase). Must match the currency of your Stripe account.
productstringrequiredID of the product this price belongs to. Create a product first if you do not have one.
unit_amountnumberrequiredPrice in the smallest currency unit (e.g. cents for USD). 2000 = .00. Use 0 for free prices.
recurringobjectoptionalInclude to create a recurring/subscription price. Omit for one-time prices. interval must be day, week, month, or year.
stripemcp_create_product#[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Create a product in Stripe representing a good or service. Products are the parent objects for prices — create a product first, then attach prices to it.2 params

[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Create a product in Stripe representing a good or service. Products are the parent objects for prices — create a product first, then attach prices to it.

NameTypeRequiredDescription
namestringrequiredProduct name shown on invoices and in the Stripe dashboard.
descriptionstringoptionalOptional product description shown on invoices and checkout pages.
stripemcp_create_refund#Issue a full or partial refund for a succeeded PaymentIntent. Omit amount to refund the full charge. The PaymentIntent must have a successful charge — refunding a pending or failed intent will error.6 params

Issue a full or partial refund for a succeeded PaymentIntent. Omit amount to refund the full charge. The PaymentIntent must have a successful charge — refunding a pending or failed intent will error.

NameTypeRequiredDescription
livemodebooleanrequiredWhether to operate in livemode (true) or test mode/ sandbox (false). Must match the livemode of the stripe_context account.
payment_intentstringrequiredID of the PaymentIntent to refund. The payment must have a succeeded charge. Get it from the charge or invoice object.
stripe_contextstringrequiredThe account to target for this request. Use the `stripe_context` value returned by list_available_accounts_or_orgs.
amountintegeroptionalAmount to refund in cents. Omit to refund the full amount. Must be less than or equal to the original charge amount.
human_confirmationobjectoptionalOptional confirmation object for human-in-the-loop approval flows. Pass {"confirmed": true} to bypass the approval step when running in an automated context.
reasonstringoptionalReason for the refund. Valid values: duplicate, fraudulent, requested_by_customer. Shown on the refund receipt.
stripemcp_fetch_stripe_resources#[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Retrieve a Stripe object by its ID. Works with any Stripe resource ID (cus_..., pi_..., in_..., sub_..., prod_..., price_..., dp_...). Returns the full object details.1 param

[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Retrieve a Stripe object by its ID. Works with any Stripe resource ID (cus_..., pi_..., in_..., sub_..., prod_..., price_..., dp_...). Returns the full object details.

NameTypeRequiredDescription
idstringrequiredID of any Stripe object to retrieve (e.g. cus_..., pi_..., in_..., sub_..., prod_..., price_..., dp_...). The resource type is inferred from the ID prefix.
stripemcp_finalize_invoice#[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Finalize a draft invoice to lock it and make it ready for payment. After finalization, the invoice status changes from draft to open and a PaymentIntent is created automatically.1 param

[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Finalize a draft invoice to lock it and make it ready for payment. After finalization, the invoice status changes from draft to open and a PaymentIntent is created automatically.

NameTypeRequiredDescription
invoicestringrequiredID of the draft invoice to finalize. Finalization locks the invoice and generates a PaymentIntent for collection.
stripemcp_get_stripe_account_info#Retrieve information about the connected Stripe account, including account ID, business name, country, currency, and account type (standard, express, or custom).2 params

Retrieve information about the connected Stripe account, including account ID, business name, country, currency, and account type (standard, express, or custom).

NameTypeRequiredDescription
livemodebooleanrequiredWhether to operate in livemode (true) or test mode/ sandbox (false). Must match the livemode of the stripe_context account.
stripe_contextstringrequiredThe account to target for this request. Use the `stripe_context` value returned by list_available_accounts_or_orgs.
stripemcp_list_available_accounts_or_orgs#Lists all Stripe accounts available in this session with their stripe_context and livemode values. Call this first to get stripe_context and livemode before any account-specific operation. Ask the user which account to use unless already specified, and warn before switching between test mode and live mode.0 params

Lists all Stripe accounts available in this session with their stripe_context and livemode values. Call this first to get stripe_context and livemode before any account-specific operation. Ask the user which account to use unless already specified, and warn before switching between test mode and live mode.

stripemcp_manage_stripe_accounts#Returns a URL to the Stripe Dashboard where the user can add accounts, remove accounts, or change permissions for this session. Use when the user wants to add, remove, or modify permissions for an account — no need to call list_available_accounts_or_orgs first. After the user confirms they completed their changes, call list_available_accounts_or_orgs to sync the updated account list.0 params

Returns a URL to the Stripe Dashboard where the user can add accounts, remove accounts, or change permissions for this session. Use when the user wants to add, remove, or modify permissions for an account — no need to call list_available_accounts_or_orgs first. After the user confirms they completed their changes, call list_available_accounts_or_orgs to sync the updated account list.

stripemcp_retrieve_balance#[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Retrieve the current balance for the connected Stripe account, broken down by currency and availability (available vs. pending funds).0 params

[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Retrieve the current balance for the connected Stripe account, broken down by currency and availability (available vs. pending funds).

stripemcp_search_stripe_documentation#Search Stripe official documentation and API reference for answers. Use this to look up Stripe concepts, API parameters, error codes, or integration guidance.3 params

Search Stripe official documentation and API reference for answers. Use this to look up Stripe concepts, API parameters, error codes, or integration guidance.

NameTypeRequiredDescription
questionstringrequiredThe question or topic to search Stripe documentation for.
languagestringoptionalProgramming language for code examples in results. Defaults to no specific language.
search_only_api_refbooleanoptionalSet to true to search only the API reference. Set to false (default) to search all documentation including guides and tutorials.
stripemcp_search_stripe_resources#[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Search Stripe resources using the format resource:query (e.g. customers:name:"Acme" or invoices:status:"open"). Valid resources: customers, payment_intents, charges, invoices, prices, products, subscriptions.1 param

[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Search Stripe resources using the format resource:query (e.g. customers:name:"Acme" or invoices:status:"open"). Valid resources: customers, payment_intents, charges, invoices, prices, products, subscriptions.

NameTypeRequiredDescription
querystringrequiredSearch query in resource:search_term format. Valid resources: customers, payment_intents, charges, invoices, prices, products, subscriptions. Example: customers:name:"Acme" or invoices:status:"open".
stripemcp_send_stripe_mcp_feedback#Submit feedback about a Stripe MCP tool experience. Use source=user for feedback from a human, source=agent for feedback generated by an AI agent.5 params

Submit feedback about a Stripe MCP tool experience. Use source=user for feedback from a human, source=agent for feedback generated by an AI agent.

NameTypeRequiredDescription
contextstringrequiredAdditional context about what you were trying to do when you used the tool.
quotestringrequiredA direct quote or specific observation about the tool experience.
sentimentstringrequiredSentiment of the feedback. Valid values: positive, negative, neutral.
sourcestringrequiredWho generated this feedback. Valid values: user (human feedback), agent (AI-generated feedback).
tool_namestringoptionalName of the specific Stripe MCP tool this feedback is about.
stripemcp_stripe_analytics#Analyze Stripe data (e.g. revenue, products, or payments) and run SQL-based reporting queries. Supports ad-hoc SQL (execute_query_run/retrieve_query_run against searchable tables via search_query_tables/retrieve_query_table) and pre-built subscription/billing metric templates (execute_query_template/retrieve_query_template). Monetary values are returned in the smallest currency unit.4 params

Analyze Stripe data (e.g. revenue, products, or payments) and run SQL-based reporting queries. Supports ad-hoc SQL (execute_query_run/retrieve_query_run against searchable tables via search_query_tables/retrieve_query_table) and pre-built subscription/billing metric templates (execute_query_template/retrieve_query_template). Monetary values are returned in the smallest currency unit.

NameTypeRequiredDescription
intentstringrequiredThe intent of the tool call.
livemodebooleanrequiredWhether to operate in livemode (true) or test mode/ sandbox (false). Must match the livemode of the stripe_context account.
stripe_contextstringrequiredThe account to target for this request. Use the `stripe_context` value returned by list_available_accounts_or_orgs.
paramsobjectoptionalThe parameters for the tool call. Required parameters depend on the intent.
stripemcp_stripe_api_details#Get the full parameter schema for a specific Stripe API operation. Use stripe_api_search to find the operation ID first (e.g. GetCustomers, PostRefunds), then call this to see all available parameters.3 params

Get the full parameter schema for a specific Stripe API operation. Use stripe_api_search to find the operation ID first (e.g. GetCustomers, PostRefunds), then call this to see all available parameters.

NameTypeRequiredDescription
livemodebooleanrequiredWhether to operate in livemode (true) or test mode/ sandbox (false). Must match the livemode of the stripe_context account.
stripe_api_operation_idstringrequiredThe Stripe API operation ID to get details for. Get valid IDs from stripe_api_search (e.g. GetCustomers, PostRefunds, PostSubscriptions).
stripe_contextstringrequiredThe account to target for this request. Use the `stripe_context` value returned by list_available_accounts_or_orgs.
stripemcp_stripe_api_execute#[SUPERSEDED — upstream split stripe_api_execute into stripe_api_read (GET operations) and stripe_api_write (POST/DELETE operations), each also requiring stripe_context/livemode. Flagged per SK-1675, not deleted; see stripemcp_stripe_api_read and stripemcp_stripe_api_write.] Execute any Stripe API operation by its operation ID and parameters. Use stripe_api_search to discover available operations and stripe_api_details to see their parameters before executing.3 params

[SUPERSEDED — upstream split stripe_api_execute into stripe_api_read (GET operations) and stripe_api_write (POST/DELETE operations), each also requiring stripe_context/livemode. Flagged per SK-1675, not deleted; see stripemcp_stripe_api_read and stripemcp_stripe_api_write.] Execute any Stripe API operation by its operation ID and parameters. Use stripe_api_search to discover available operations and stripe_api_details to see their parameters before executing.

NameTypeRequiredDescription
parametersobjectrequiredParameters to pass to the Stripe API operation. Must match the schema returned by stripe_api_details. Pass as a JSON object.
stripe_api_operation_idstringrequiredThe Stripe API operation ID to execute. Use stripe_api_search to find available operations and stripe_api_details to see required parameters.
human_confirmationobjectoptionalOptional confirmation object for human-in-the-loop approval flows. Pass {"confirmed": true} to bypass the approval step when running in an automated context.
stripemcp_stripe_api_read#Execute a read-only (GET) Stripe API operation by its operation ID and parameters. Use stripe_api_search to discover available operations and stripe_api_details to see their parameters before executing.4 params

Execute a read-only (GET) Stripe API operation by its operation ID and parameters. Use stripe_api_search to discover available operations and stripe_api_details to see their parameters before executing.

NameTypeRequiredDescription
livemodebooleanrequiredWhether to operate in livemode (true) or test mode/ sandbox (false). Must match the livemode of the stripe_context account.
parametersobjectrequiredParameters for the API call. Include path parameters (e.g. 'customer' for /v1/customers/{customer}), query parameters, and body parameters. Array fields (e.g. line_items) must be passed as a JSON array value, not as a plain string.
stripe_api_operation_idstringrequiredThe operation ID to execute (e.g. PostCustomers, GetPaymentIntents).
stripe_contextstringrequiredThe account to target for this request. Use the `stripe_context` value returned by list_available_accounts_or_orgs.
stripemcp_stripe_api_write#Execute a write (POST/DELETE) Stripe API operation by its operation ID and parameters. Use stripe_api_search to discover available operations and stripe_api_details to see their parameters before executing. May require human confirmation for sensitive operations.5 params

Execute a write (POST/DELETE) Stripe API operation by its operation ID and parameters. Use stripe_api_search to discover available operations and stripe_api_details to see their parameters before executing. May require human confirmation for sensitive operations.

NameTypeRequiredDescription
livemodebooleanrequiredWhether to operate in livemode (true) or test mode/ sandbox (false). Must match the livemode of the stripe_context account.
parametersobjectrequiredParameters for the API call. Include path parameters (e.g. 'customer' for /v1/customers/{customer}), query parameters, and body parameters. Array fields (e.g. line_items) must be passed as a JSON array value, not as a plain string.
stripe_api_operation_idstringrequiredThe operation ID to execute (e.g. PostCustomers, GetPaymentIntents).
stripe_contextstringrequiredThe account to target for this request. Use the `stripe_context` value returned by list_available_accounts_or_orgs.
human_confirmationobjectoptionalThis tool might require human confirmation. To run it, first invoke it with the desired parameters, ignoring the `approval_token` parameter. If it requires human confirmation, the response will include an approval request ID and a URL to an approval page for the human to approve the tool call. Present this URL to the human as a clickable markdown link, and after they confirm approval, call the tool again with the same parameters plus `approval_token`.
stripemcp_stripe_implementation_planner#Stripe payment integration planner. Use this BEFORE writing code when the user wants to accept payments, sell products online, set up billing, or build any Stripe integration — it returns use cases, decision trees, documentation links, and a guide_id for follow-up calls. Successor to stripe_integration_recommender.5 params

Stripe payment integration planner. Use this BEFORE writing code when the user wants to accept payments, sell products online, set up billing, or build any Stripe integration — it returns use cases, decision trees, documentation links, and a guide_id for follow-up calls. Successor to stripe_integration_recommender.

NameTypeRequiredDescription
livemodebooleanrequiredWhether to operate in livemode (true) or test mode/ sandbox (false). Must match the livemode of the stripe_context account.
messagestringrequiredFor new guides: describe the use case or business requirements. For existing guides: provide the latest user response or the full accepted transcript.
stripe_contextstringrequiredThe account to target for this request. Use the `stripe_context` value returned by list_available_accounts_or_orgs.
acceptbooleanoptionalSet to true when returning the completed decision tree with your chosen options to receive the finalized integration guide.
guide_idstringoptionalONLY pass a guide_id that was returned by a previous call to this tool in this conversation. Never fabricate, guess, or reuse guide_ids from other sessions. If you do not have a guide_id from a prior response, omit this field entirely. Invalid guide_ids will be rejected.
stripemcp_stripe_integration_recommender#[SUPERSEDED — upstream renamed/restructured this tool to stripe_implementation_planner (guide_id/message/accept flow, plus required stripe_context/livemode). Flagged per SK-1675, not deleted; see stripemcp_stripe_implementation_planner.] Get a recommendation on which Stripe integration pattern best fits a use case (e.g. Checkout, Payment Intents, Billing). Describe the payment scenario in the answer field.3 params

[SUPERSEDED — upstream renamed/restructured this tool to stripe_implementation_planner (guide_id/message/accept flow, plus required stripe_context/livemode). Flagged per SK-1675, not deleted; see stripemcp_stripe_implementation_planner.] Get a recommendation on which Stripe integration pattern best fits a use case (e.g. Checkout, Payment Intents, Billing). Describe the payment scenario in the answer field.

NameTypeRequiredDescription
answerstringrequiredDescribe your payment scenario or what you want to build. Be specific about whether payments are one-time or recurring, and whether you need a hosted checkout or custom UI.
notesstringoptionalAdditional context about your integration requirements, constraints, or current setup.
plan_idstringoptionalOptional Stripe product or plan ID if you already have a pricing structure set up. Must follow format lplan_... Leave blank if not applicable.
stripemcp_update_dispute#[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Submit evidence or update an open Stripe dispute (chargeback). Pass submit=true to send the evidence to Stripe immediately, or false to save it as a draft for later submission.3 params

[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Submit evidence or update an open Stripe dispute (chargeback). Pass submit=true to send the evidence to Stripe immediately, or false to save it as a draft for later submission.

NameTypeRequiredDescription
disputestringrequiredID of the dispute to update. Get dispute IDs from the Stripe dashboard or by listing disputes via stripe_api_execute with GetDisputes.
evidenceobjectoptionalEvidence object to submit for the dispute. Include fields like customer_purchase_ip, product_description, and shipping_documentation as applicable.
submitbooleanoptionalSet to true to submit the evidence to Stripe immediately. Set to false to save as a draft. Once submitted, evidence cannot be changed.
stripemcp_update_subscription#[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Update an active subscription — change its price, quantity, or proration behavior. Use proration_behavior=create_prorations to credit unused time when upgrading plans.3 params

[STALE — not found in live upstream MCP discovery as of 2026-08-19; Stripe's MCP server has been restructured around stripe_api_read/stripe_api_write/stripe_api_search/stripe_api_details plus multi-account stripe_context/livemode params. Flagged per SK-1675, not deleted, pending confirmation this capability is fully gone rather than temporarily unlisted.] Update an active subscription — change its price, quantity, or proration behavior. Use proration_behavior=create_prorations to credit unused time when upgrading plans.

NameTypeRequiredDescription
subscriptionstringrequiredID of the subscription to update.
itemsarrayoptionalArray of subscription items to update. Each item needs the subscription item ID (si_...) and new price ID. Used to change plan or quantity.
proration_behaviorstringoptionalHow to handle proration when changing plans mid-cycle. create_prorations credits unused time; none skips proration; always_invoice immediately bills the difference.