Stripe Model Context Protocol

The Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.

Setup

Stripe hosts a remote MCP server at https://mcp.stripe.com. View the docs here. To run the Stripe MCP server locally using npx, use the following command:

# To set up all available tools
npx -y @stripe/mcp --tools=all --api-key=YOUR_STRIPE_SECRET_KEY

# To set up specific tools
npx -y @stripe/mcp --tools=customers.create,customers.read,products.create --api-key=YOUR_STRIPE_SECRET_KEY

# To configure a Stripe connected account
npx -y @stripe/mcp --tools=all --api-key=YOUR_STRIPE_SECRET_KEY --stripe-account=CONNECTED_ACCOUNT_ID

Make sure to replace YOUR_STRIPE_SECRET_KEY with your actual Stripe secret key. Alternatively, you could set the STRIPE_SECRET_KEY in your environment variables.

Usage with Claude Desktop

Add the following to your claude_desktop_config.json. See here for more details.

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

of if you're using Docker

{
    “mcpServers”: {
        “stripe”: {
            “command”: “docker",
            “args”: [
                “run”,
                "--rm",
                "-i",
                “mcp/stripe”,
                “--tools=all”,
                “--api-key=STRIPE_SECRET_KEY”
            ]
        }
    }
}

Available tools

Tool	Description
`balance.read`	Retrieve balance information
`coupons.create`	Create a new coupon
`coupons.read`	Read coupon information
`customers.create`	Create a new customer
`customers.read`	Read customer information
`disputes.read`	Read disputes information
`disputes.update`	Update an existing dispute
`documentation.read`	Search Stripe documentation
`invoiceItems.create`	Create a new invoice item
`invoices.create`	Create a new invoice
`invoices.update`	Update an existing invoice
`paymentIntents.read`	Read payment intent information
`paymentLinks.create`	Create a new payment link
`prices.create`	Create a new price
`prices.read`	Read price information
`products.create`	Create a new product
`products.read`	Read product information
`refunds.create`	Create a new refund
`subscriptions.read`	Read subscription information
`subscriptions.update`	Update subscription information

Debugging the Server

To debug your server, you can use the MCP Inspector.

First build the server

npm run build

Run the following command in your terminal:

# Start MCP Inspector and server with all tools
npx @modelcontextprotocol/inspector node dist/index.js --tools=all --api-key=YOUR_STRIPE_SECRET_KEY

Build using Docker