Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Stripe MCP connector

OAuth 2.1/DCR Accounting & 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_get_stripe_account_info',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Update subscription, dispute — Update an active subscription — change its price, quantity, or proration behavior
  • Recommender stripe integration — Get a recommendation on which Stripe integration pattern best fits a use case (e.g
  • Search stripe api, stripe resources, stripe documentation — Search available Stripe API operations by keyword
  • Execute stripe api — Execute any Stripe API operation by its operation ID and parameters
  • Details stripe api — Get the full parameter schema for a specific Stripe API operation
  • Send stripe mcp feedback — Submit feedback about a Stripe MCP tool experience

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 # 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

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.

Name Type Required Description
subscription string required ID of the subscription to cancel immediately. Cancellation is permanent — the subscription cannot be reactivated.
stripemcp_create_coupon # 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

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.

Name Type Required Description
name string required Internal name for the coupon shown in the Stripe dashboard and on invoices.
amount_off number optional Fixed discount amount in the smallest currency unit (e.g. 500 = .00 off). Requires currency. Use this or percent_off — not both.
currency string optional Required when using amount_off. Three-letter ISO currency code matching the discount amount.
duration string optional How long the coupon applies: once (first invoice only), forever (all invoices), or repeating (for duration_in_months months).
duration_in_months number optional Number of months the discount applies when duration is repeating.
percent_off number optional Percentage discount between 0 and 100. Use this or amount_off — not both.
stripemcp_create_customer # 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

Create a new Stripe customer record with a name and optional email. Returns the customer ID (cus_...) used in invoices, subscriptions, and payment intents.

Name Type Required Description
name string required Full name of the customer as it will appear on invoices and receipts.
email string optional Customer email address. Used for receipt delivery and customer lookup.
stripemcp_create_invoice # 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

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.

Name Type Required Description
customer string required ID of the Stripe customer to bill. Add line items with Create Invoice Item after creating the invoice.
days_until_due number optional Payment 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 # 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

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.

Name Type Required Description
customer string required ID of the customer the invoice belongs to. Must match the customer on the invoice.
invoice string required ID of the draft invoice to add this line item to. Invoice must be in draft status.
price string required ID of the price to add as a line item. The price determines amount and currency.
stripemcp_create_price # 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

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.

Name Type Required Description
currency string required Three-letter ISO 4217 currency code (lowercase). Must match the currency of your Stripe account.
product string required ID of the product this price belongs to. Create a product first if you do not have one.
unit_amount number required Price in the smallest currency unit (e.g. cents for USD). 2000 = .00. Use 0 for free prices.
recurring object optional Include to create a recurring/subscription price. Omit for one-time prices. interval must be day, week, month, or year.
stripemcp_create_product # 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

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.

Name Type Required Description
name string required Product name shown on invoices and in the Stripe dashboard.
description string optional Optional 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. 4 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.

Name Type Required Description
payment_intent string required ID of the PaymentIntent to refund. The payment must have a succeeded charge. Get it from the charge or invoice object.
amount integer optional Amount to refund in cents. Omit to refund the full amount. Must be less than or equal to the original charge amount.
human_confirmation object optional Optional confirmation object for human-in-the-loop approval flows. Pass {"confirmed": true} to bypass the approval step when running in an automated context.
reason string optional Reason for the refund. Valid values: duplicate, fraudulent, requested_by_customer. Shown on the refund receipt.
stripemcp_fetch_stripe_resources # 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

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.

Name Type Required Description
id string required ID 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 # 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

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.

Name Type Required Description
invoice string required ID 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). 0 params

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

stripemcp_retrieve_balance # Retrieve the current balance for the connected Stripe account, broken down by currency and availability (available vs. pending funds). 0 params

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.

Name Type Required Description
question string required The question or topic to search Stripe documentation for.
language string optional Programming language for code examples in results. Defaults to no specific language.
search_only_api_ref boolean optional Set to true to search only the API reference. Set to false (default) to search all documentation including guides and tutorials.
stripemcp_search_stripe_resources # 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

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.

Name Type Required Description
query string required Search 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.

Name Type Required Description
context string required Additional context about what you were trying to do when you used the tool.
quote string required A direct quote or specific observation about the tool experience.
sentiment string required Sentiment of the feedback. Valid values: positive, negative, neutral.
source string required Who generated this feedback. Valid values: user (human feedback), agent (AI-generated feedback).
tool_name string optional Name of the specific Stripe MCP tool this feedback is about.
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. 1 param

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.

Name Type Required Description
stripe_api_operation_id string required The Stripe API operation ID to get details for. Get valid IDs from stripe_api_search (e.g. GetCustomers, PostRefunds, PostSubscriptions).
stripemcp_stripe_api_execute # 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

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.

Name Type Required Description
parameters object required Parameters to pass to the Stripe API operation. Must match the schema returned by stripe_api_details. Pass as a JSON object.
stripe_api_operation_id string required The Stripe API operation ID to execute. Use stripe_api_search to find available operations and stripe_api_details to see required parameters.
human_confirmation object optional Optional 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_integration_recommender # 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

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.

Name Type Required Description
answer string required Describe 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.
notes string optional Additional context about your integration requirements, constraints, or current setup.
plan_id string optional Optional 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 # 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

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.

Name Type Required Description
dispute string required ID of the dispute to update. Get dispute IDs from the Stripe dashboard or by listing disputes via stripe_api_execute with GetDisputes.
evidence object optional Evidence object to submit for the dispute. Include fields like customer_purchase_ip, product_description, and shipping_documentation as applicable.
submit boolean optional Set 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 # 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

Update an active subscription — change its price, quantity, or proration behavior. Use proration_behavior=create_prorations to credit unused time when upgrading plans.

Name Type Required Description
subscription string required ID of the subscription to update.
items array optional Array of subscription items to update. Each item needs the subscription item ID (si_...) and new price ID. Used to change plan or quantity.
proration_behavior string optional How to handle proration when changing plans mid-cycle. create_prorations credits unused time; none skips proration; always_invoice immediately bills the difference.