modelcontextprotocol

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”
            ]
        }
    }
}

Usage with Gemini CLI

1. Install Gemini CLI through your preferred method.
2. Install the Stripe MCP extension: gemini extensions install https://github.com/stripe/agent-toolkit.
3. Start Gemini CLI: gemini.
4. Go through the OAUTH flow: /mcp auth stripe.

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.read	Read invoice information
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

First build the server

docker build -t mcp/stripe .

Run the following command in your terminal:

docker run -p 3000:3000 -p 5173:5173 -v /var/run/docker.sock:/var/run/docker.sock mcp/inspector docker run --rm -i mcp/stripe --tools=all --api-key=YOUR_STRIPE_SECRET_KEY

Instructions

1. Replace YOUR_STRIPE_SECRET_KEY with your actual Stripe API secret key.
2. Run the command to start the MCP Inspector.
3. Open the MCP Inspector UI in your browser and click Connect to start the MCP server.
4. You can see the list of tools you selected and test each tool individually.