Stripe MCP Server

Official Stripe MCP server for interacting with the Stripe API and knowledge base to manage payments, customers, subscriptions, invoices, and billing.

Payments by Stripe OAuth2 active

Connect (Remote Server) GitHub Docs npm: @stripe/mcp

Overview

The Stripe MCP server is the official Model Context Protocol integration maintained by Stripe. It exposes the Stripe API and Stripe's documentation knowledge base as tools that AI agents can call to manage payments, customers, products, prices, invoices, subscriptions, payment links, refunds, disputes, and coupons. Stripe hosts a remote server at https://mcp.stripe.com with OAuth-based authentication, and also publishes a local server option through the @stripe/mcp npm package that authenticates with a Stripe secret or restricted API key.

The server includes both action tools (create_customer, create_invoice, update_subscription, create_refund, etc.) and search/discovery tools (search_stripe_resources, search_stripe_documentation, fetch_stripe_resources) so agents can both perform billing operations and reference Stripe's docs in the same workflow. Tool permissions are governed by the API key in use, so teams can scope an agent's access using Restricted API Keys (RAKs) from the Stripe Dashboard.

The server supports both sandbox (test mode) and live mode, and Stripe recommends OAuth over raw secret keys for production agents because it provides user-level authorization and granular permission scoping. Administrators can enable, audit, and revoke MCP access from the Stripe Dashboard.

Tools

Tool	Description
`get_stripe_account_info`	Retrieve details about the connected Stripe account.
`retrieve_balance`	Return the current Stripe account balance.
`create_customer`	Create a new customer record in Stripe.
`list_customers`	List existing customers, with optional filters.
`create_product`	Create a new product.
`list_products`	List products in the account.
`create_price`	Create a price for a product.
`list_prices`	List prices, optionally filtered by product.
`create_invoice`	Create a draft invoice for a customer.
`finalize_invoice`	Finalize a draft invoice so it can be paid.
`list_invoices`	List invoices, optionally filtered by customer or status.
`create_invoice_item`	Add a line item to a pending invoice.
`create_payment_link`	Create a shareable payment link for a price.
`list_payment_intents`	List PaymentIntents.
`cancel_subscription`	Cancel an active subscription.
`list_subscriptions`	List subscriptions, optionally filtered by customer or status.
`update_subscription`	Update an existing subscription (plan, quantity, metadata).
`create_coupon`	Create a discount coupon.
`list_coupons`	List existing coupons.
`list_disputes`	List chargeback disputes on the account.
`update_dispute`	Submit or update evidence on a dispute.
`create_refund`	Refund a charge or payment intent.
`search_stripe_resources`	Search across Stripe resources (customers, invoices, charges, etc.).
`search_stripe_documentation`	Search Stripe's documentation and support knowledge base.
`fetch_stripe_resources`	Fetch a specific Stripe resource by ID.

Setup Guide

Remote server (recommended)

Stripe hosts the MCP server at https://mcp.stripe.com. Authenticate with OAuth from the Dashboard or pass a Restricted API Key as a Bearer token.

Cursor:

{
  "mcpServers": {
    "stripe": {
      "url": "https://mcp.stripe.com"
    }
  }
}

VS Code:

{
  "servers": {
    "stripe": {
      "type": "http",
      "url": "https://mcp.stripe.com"
    }
  }
}

Local server (Claude Desktop or self-hosted)

Run the published @stripe/mcp package with a secret or restricted API key:

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": ["-y", "@stripe/mcp@latest"],
      "env": {
        "STRIPE_SECRET_KEY": "sk_test_..."
      }
    }
  }
}

Or via CLI:

npx -y @stripe/mcp@latest --api-key=sk_test_...

Prerequisites

A Stripe account.
A Restricted API Key (recommended) created at https://dashboard.stripe.com/apikeys, scoped to only the resources the agent needs.
Node.js 18+ for the local server.
For workspaces, an admin must enable MCP access for the account.

Use Cases

Spin up new customers, products, and prices directly from a chat or agent workflow when onboarding a new account.
Generate and finalize invoices for ad-hoc billing without leaving the AI tool, then share a payment link with the customer.
Manage subscription lifecycle: cancel, upgrade, or change quantity on a Stripe subscription based on a support ticket or CRM update.
Triage chargebacks by listing disputes, fetching transaction context, and submitting evidence drafts for review.
Answer "how do I do X in Stripe" questions by searching the Stripe documentation and pulling the relevant API references inline.

Example Prompts

"Create a Stripe customer for jane@acme.com, then send her a $499 invoice with net 30 terms."
"List all active subscriptions for customer cus_123 and cancel any that are past due."
"Create a 20% off coupon valid for 3 months and generate a payment link for the Pro plan."
"Show me all open disputes from the last 30 days along with the dispute reasons."
"Search Stripe docs for how to handle 3D Secure authentication in a SetupIntent."

Pros

Officially built and hosted by Stripe, so tools track the real API and stay current.
Supports OAuth in addition to API key auth, with permissions scoped via Restricted API Keys for safer agent access.
Combines action tools with docs/resource search, letting an agent answer questions and execute work in one server.
Available as both a remote hosted server and a local @stripe/mcp npm package for flexible deployment.

Limitations

Workspace admins must enable MCP access, which can slow adoption in larger Stripe accounts.
Powerful write tools (refunds, subscription cancellations, dispute updates) require careful RAK scoping and human confirmation to avoid mistakes.
Tool coverage is broad but not exhaustive, some niche Stripe APIs (e.g. Issuing, Treasury, Tax) may not be fully represented.

Alternatives

Stripe Agent Toolkit for LangChain or Vercel AI SDK integrations without the MCP layer.
PayPal MCP server for similar payment and invoicing capabilities on PayPal.
Community Stripe MCP wrappers on GitHub, useful only if you need custom behavior beyond the official server.