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:

Package	Wraps	When to use
@codespar/mcp-stripe (this package)	Stripe's regular payments API (PaymentIntents, Checkout, Billing)	You are already using Stripe to accept payments today — the 99% case for LatAm SaaS that ship with Stripe.
@codespar/mcp-stripe-acp	Stripe's Agentic Commerce Protocol	You are building on Stripe's new agent-native checkout spec. Much narrower product, bleeding edge.

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)

Tool	Purpose
create_payment_intent	Create a PaymentIntent — Stripe's modern primitive for charging a customer.
confirm_payment_intent	Confirm a PaymentIntent created with confirm=false.
retrieve_payment_intent	Retrieve a PaymentIntent by id.
cancel_payment_intent	Cancel a PaymentIntent.
list_payment_intents	List PaymentIntents.
create_refund	Refund a charge or a PaymentIntent.
list_refunds	List Refunds.
create_customer	Create a Stripe Customer.
retrieve_customer	Retrieve a Customer by id.
update_customer	Update a Customer.
create_product	Create a Product — the catalog entity Prices reference.
list_products	List Products.
create_price	Create a Price attached to a Product.
list_prices	List Prices.
create_subscription	Create a Subscription for an existing customer.
update_subscription	Update a Subscription.
cancel_subscription	Cancel a Subscription.
list_subscriptions	List Subscriptions.
create_checkout_session	Create a hosted Checkout Session.
create_payment_link	Create a long-lived Payment Link (shareable URL) that charges a price or set of line items.
list_payment_links	List Payment Links.
create_invoice	Create an Invoice draft for a customer.
list_invoices	List Invoices.
finalize_invoice	Finalize a draft Invoice.
send_invoice	Send a finalized Invoice to the customer by email.
pay_invoice	Attempt to collect payment on an open Invoice.
void_invoice	Void a finalized Invoice.
update_dispute	Submit evidence on a Dispute.
list_disputes	List Disputes.
retrieve_balance	Retrieve the current Stripe account balance — available, pending, and connect_reserved funds broken down by...

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

Variable	Required	Description
STRIPE_SECRET_KEY	Yes	sk_test_... or sk_live_... from Stripe Dashboard > Developers > API keys
STRIPE_API_VERSION	No	Pin API version via the Stripe-Version header (e.g. 2024-06-20)

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