mcp-stripe-helper

An MCP server that helps developers write, debug, and test Stripe integration code. This is a coding helper, not a Stripe API wrapper — no API keys needed, no network calls to Stripe.

Tools

| Tool | What it does | |------|-------------| | stripe_code_example | Generate working code examples for common Stripe operations (TypeScript/Python) | | stripe_webhook_validator | Inspect webhook event structures — payload shape, required fields, gotchas | | stripe_error_helper | Explain Stripe error codes with causes and fix suggestions | | stripe_migration_guide | Get breaking changes and migration steps between API versions | | stripe_test_data | Generate realistic test fixtures for Stripe objects (JSON) |

Install

npx -y mcp-stripe-helper

Claude Desktop / Claude Code

Add to your MCP config:

{
  "mcpServers": {
    "stripe-helper": {
      "command": "npx",
      "args": ["-y", "mcp-stripe-helper"]
    }
  }
}

Cursor / Windsurf / other MCP clients

Same config format — add to your MCP settings file.

Usage Examples

Get a webhook handler example:

"Show me how to handle checkout.session.completed webhooks in TypeScript"

Uses stripe_code_example with operation handle_webhook + stripe_webhook_validator with event checkout.session.completed.

Debug a Stripe error:

"I'm getting card_declined — what does it mean?"

Uses stripe_error_helper with error card_declined.

Generate test data:

"Give me 5 test customers for my test suite"

Uses stripe_test_data with object_type customer, count 5.

Plan an API upgrade:

"What breaks between Stripe API 2023-08-16 and 2024-12-18?"

Uses stripe_migration_guide with the two versions.

Supported Operations (stripe_code_example)

• create_customer — Create and configure a Stripe customer
• charge_card — Charge a card using PaymentIntents (modern approach)
• setup_subscription — Create and cancel subscriptions with SCA support
• handle_webhook — Full webhook handler with signature verification
• create_checkout_session — One-time and subscription checkout flows
• create_payment_intent — Custom payment flow with client_secret
• create_product_and_price — Products with one-time and recurring prices
• attach_payment_method — Attach and set default payment methods
• create_portal_session — Customer self-service billing portal
• list_invoices — List and create invoices

Development

npm install
npm run build
npm start

License

MIT