Stripe MCP Server

What it does

The Stripe MCP Server connects AI coding agents to the Stripe API. Agents can create and read customers, products, prices, payment links, invoices, refunds, payment intents, subscriptions, coupons, and balance data. You can scope which tools are enabled to limit the agent's capabilities. Stripe also offers a hosted MCP server at https://mcp.stripe.com with OAuth.

Available tools

Tool	What it does
customers.create	Create a new customer
customers.read	Retrieve customer by ID
products.create	Create a product
products.read	Retrieve product by ID
prices.create	Create a price
prices.read	Retrieve price by ID
payment_links.*	Create and manage payment links
invoices.*	Create and manage invoices
refunds.*	Create and list refunds
payment_intents.*	Create and retrieve payment intents
subscriptions.*	Create and manage subscriptions
coupons.*	Create and list coupons
balance	Retrieve account balance
docs_search	Search Stripe documentation

Use --tools=... to enable only specific tools (e.g., --tools=customers.create,customers.read).

Setup by tool

Cursor

Create .cursor/mcp.json:

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": ["-y", "@stripe/mcp", "--api-key=sk_test_your_key"],
      "env": {
        "STRIPE_SECRET_KEY": "sk_test_your_key"
      }
    }
  }
}

Or omit --api-key and rely on STRIPE_SECRET_KEY in env. Add --tools=customers.read,products.read to restrict tools.

Claude Code

Add to your Claude configuration:

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

VS Code / GitHub Copilot

Add the same configuration. For OAuth, use the hosted server: "url": "https://mcp.stripe.com" and complete the OAuth flow when prompted.

Connected accounts

For Connect platforms, add --stripe-account=acct_xxx or set STRIPE_ACCOUNT in env.

When to use this

• Checkout integration: Agents generate payment links and handle customer creation
• Subscription flows: Implement and debug subscription logic with real Stripe context
• Invoice handling: Create and manage invoices from the IDE
• Docs lookup: Search Stripe documentation during implementation
• Testing: Use test-mode keys to exercise flows without real charges

Security considerations

• Use test-mode keys (sk_test_) for development; never commit live keys
• Restrict tools with --tools= to the minimum required
• For production, prefer the hosted OAuth server over embedding secret keys
• Connected account scope limits operations to that account
• Rotate API keys if they may have been exposed
• Never log or expose secret keys in agent output