A command line tool for setting up Stripe MCP server
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.
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:
``bashTo set up all available tools
npx -y @stripe/mcp --tools=all --api-key=YOUR_STRIPE_SECRET_KEY
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.$3
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”
]
}
}
}`$3
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:
`bash
Start MCP Inspector and server with all tools
npx @modelcontextprotocol/inspector node dist/index.js --tools=all --api-key=YOUR_STRIPE_SECRET_KEY
`$3
First build the server
`
docker build -t mcp/stripe .
`Run the following command in your terminal:
`bash
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`$3
1. Replace
YOUR_STRIPE_SECRET_KEY` with your actual Stripe API secret key.