MCP Stripe

@codespar/mcp-stripe

MCP server for Stripe — global standard-bearer payments API

Stripe vs. Stripe ACP

Two Stripe MCP servers live in the CodeSpar catalog — different products:

If you are a typical SaaS with Stripe as your PSP, this is the package.

Why Stripe in the CodeSpar catalog?

Stripe is the global standard-bearer for developer-first payments. Nearly every LatAm SaaS that bills international cards ships with Stripe — Truora, Platzi, Rappi Pay (for some flows), countless Y Combinator LatAm companies. Adding Stripe lets agents operate the payments stack those SaaS already run, without forcing a migration to a local-first gateway.

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{

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

Claude Code

claude mcp add stripe -- npx @codespar/mcp-stripe

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

{

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

Tools (30)

Authentication

Stripe uses a single secret key. The key prefix selects the environment:

• sk_test_... → test mode (no real money moves)
• sk_live_... → live mode

There is no separate base URL — the key itself routes requests. Set STRIPE_SECRET_KEY and you are done.

Request bodies are application/x-www-form-urlencoded with bracket notation (customer[name]=Foo, metadata[order]=123, expand[]=latest_invoice). This server handles nested objects and arrays for you.

Pinning an API version

Stripe auto-upgrades breaking changes on a calendar cadence. If you want to lock the version your agent sees, set STRIPE_API_VERSION (e.g. 2024-06-20). The server passes it as the Stripe-Version header on every call.

Environment Variables

Sandbox / Testing

Every Stripe account has test mode built in — no separate signup. Use a sk_test_... key and any of Stripe's test cards (e.g. 4242 4242 4242 4242).

Get your credentials

1. Sign up at stripe.com
2. Go to Dashboard > Developers > API keys
3. Copy your Secret key (test mode by default)
4. Set STRIPE_SECRET_KEY

Roadmap

v0.2 (planned)

• update_payment_intent, capture_payment_intent (separate capture)
• retrieve_refund, list_refunds
• list_customers, search_customers
• update_subscription, retrieve_subscription
• retrieve_invoice, finalize_invoice, pay_invoice, send_invoice, void_invoice
• create_invoice_item, list_invoice_items
• create_price, create_product
• list_charges, retrieve_charge
• retrieve_dispute, close_dispute, list_disputes

v0.3 (planned)

• Stripe Connect: accounts, account links, transfers, payouts
• create_setup_intent, confirm_setup_intent (saving cards for later)
• PaymentMethod attach / detach / list
• Webhook event construction helper

Want a tool sooner? Open an issue or PR.

Links

• Stripe website
• Stripe API docs
• MCP Dev LATAM
• Landing page

Enterprise

Need governance, spend caps, and audit trails for agent-initiated charges, refunds, and subscription changes? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT