commerce-bots

Stripe MCP Server (Official, Hosted)

stripe-mcp-official

paymentsstripe

Stripe's official hosted MCP at mcp.stripe.com — a generic API gateway (stripe_api_read/stripe_api_write/stripe_api_search) plus documentation-search tools, authenticated with a Stripe secret or restricted key. Powerful but context-heavy, and writes are not idempotent by default.

When to use

Giving an agent broad, key-scoped access to the Stripe API (customers, payments, invoices, refunds) over a hosted endpoint without running a local server.

When not to use

A retrying agent that must avoid duplicate charges (writes aren't idempotent by default), or a tight context budget — the generic-gateway tool schemas are very large.

Open source

Free, functional integration code you run yourself.

Premium · managed ✦

We run it in production for you — idempotent writes, automatic retries, full visibility.

Run it for me →

What you need to integrate

Authentication

apikey · documented

Requirements

  • Rate limits: documented
  • Tool-definition budget: 5,161 tok

Setup checklist

  1. Create an API key/secret in the provider dashboard (use test/sandbox mode).
  2. Set environment variables: STRIPE_SECRET_KEY.

Env: STRIPE_SECRET_KEY

Docs & known issues

Evaluation

Create operations✗ not idempotent
Update operations✗ not idempotent

Harness-verified non-idempotent: two identical stripe_api_write calls created two distinct customers. The generic gateway sends no Idempotency-Key by default — duplicate-on-retry risk.

Works with

See the full compatibility list.