Stripe MCP
Stripe's official MCP server for your Stripe account and docs
BestMCPTools
Stripe MCP
bestmcptools.org
Last verified: September 30, 2026
Maintenance status
ActiveHow to Install Stripe MCP
$claude mcp add --transport http stripe https://mcp.stripe.com/Requires Claude Desktop, Cursor, Windsurf, or another MCP-compatible client.
Setup by client
Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"stripe-mcp": {
"url": "https://mcp.stripe.com/"
}
}
}VS Code (.vscode/mcp.json)
{
"servers": {
"stripe-mcp": {
"type": "http",
"url": "https://mcp.stripe.com/"
}
}
}Claude Code (terminal)
claude mcp add --transport http stripe-mcp https://mcp.stripe.com/Add any API keys or environment variables the server's README lists.
About Stripe MCP
Stripe MCP is Stripe's official Model Context Protocol server. It lets an AI assistant work with your Stripe account through Stripe's API and search Stripe's documentation and support articles. It can read and write: reads cover any Stripe API GET method, and writes cover POST, PATCH, PUT and DELETE methods, with human confirmation required for certain actions such as refunds. What the assistant can actually do is set by the permissions you grant.
Quick facts (as of September 30, 2026)
| Stripe MCP | |
|---|---|
| Maker | Stripe |
| Type | Hosted remote MCP server (recommended), plus a local npm package |
| Remote server | https://mcp.stripe.com |
| Authentication | OAuth for interactive clients, or an agent API key sent as a bearer token for autonomous clients |
| Access model | Read and write; permissions come from the OAuth consent or the agent key; live mode and sandboxes are separate |
| Confirmation | Stripe requires human approval for certain writes, such as refunds and outbound payments; approvals expire after 24 hours |
| Local option | npx -y @stripe/mcp --api-key=YOUR_KEY (npm package 0.3.3, published March 24, 2026, MIT, Node.js 18 or newer) |
| Docs | docs.stripe.com/mcp |
| Cost | No separate MCP charge is stated in Stripe's MCP docs. You need a Stripe account |
What it does
Stripe's docs list these tools:
| Tool | What it does |
|---|---|
stripe_api_search | Finds Stripe API methods by keyword |
stripe_api_details | Returns parameter details for one API method |
stripe_api_read | Reads data with any Stripe API GET method |
stripe_api_write | Writes data with any Stripe API POST, PATCH, PUT or DELETE method |
get_stripe_account_info | Retrieves the account |
stripe_analytics | Preview: queries metrics, analyzes subscriptions and billing and runs financial reports. Building SQL from natural language requires Sigma |
get_balance_summary | Public preview: interactive balance summary across the Stripe balance and Treasury accounts |
search_stripe_documentation | Searches Stripe's documentation |
stripe_implementation_planner | Guides you through Stripe products for accepting payments, billing or another integration |
send_stripe_feedback | Sends feedback to Stripe |
The read and write tools cover a long list of API methods. Examples from the docs: customers, charges, refunds, PaymentIntents, Checkout Sessions, invoices, subscriptions, coupons, products, prices, payment links, disputes, webhook endpoints, payouts, balance transactions and tax objects, with some preview APIs. Writes in that list include creating refunds, invoices and subscriptions and canceling subscriptions. Stripe says this exposes much of the API without filling the model's context.
Setup and authentication
- Plugin (Stripe's recommended route):
npm install -g @stripe/cli@latest, thenstripe agent setup. It detects your agents and configures the MCP server and Stripe's skills. - Claude: the official Stripe connector is in Claude's directory; or in Claude Code run
claude mcp add --transport http stripe https://mcp.stripe.com/and then authenticate with OAuth usingclaude /mcp. - Other clients: Cursor, VS Code, Codex and ChatGPT are covered in Stripe's docs. Any client can use
https://mcp.stripe.comas the server URL. - OAuth: the consent page lets you grant one or more live-mode accounts or sandboxes and set different permissions per environment. You can revoke sessions under OAuth sessions in your Stripe user settings.
- Agent API key: for clients that cannot use OAuth, create an agent key with only the permissions the client needs and send it as
Authorization: Bearer .... Test in a sandbox first.
Key change coming: Stripe's docs say that beginning October 31, 2026, Stripe MCP no longer accepts full-access secret keys or restricted API keys that lack the Agent tag. Replace them with agent keys or reconnect with OAuth. Requests with an unsupported key get a 401 response.
Administrators can turn MCP access on or off for the whole team in the Dashboard, separately for live mode and sandboxes. If a managed network blocks it, ask IT to allow mcp.stripe.com.
Limitations and things to watch
- It can change money-related data. The write tool can create refunds, invoices and subscriptions and cancel subscriptions. Stripe requires confirmation for certain actions, but you should still limit permissions, start in a sandbox and keep human confirmation on.
- Prompt injection. Stripe warns to use caution when combining its MCP server with other servers, because content from one can steer another.
- Some tools are previews.
stripe_analyticsandget_balance_summaryare marked Preview or Public preview, and some API methods are marked private or public preview. Behavior can change. - Connected accounts. For Connect platforms, Stripe says MCP does not support OAuth when acting for connected accounts; it uses a restricted key plus the
Stripe-Accountheader. Stripe's page does not say how this relates to the October 31 key change. - The local npm package is older.
@stripe/mcp0.3.3 was published March 24, 2026, and Stripe now recommends the hosted server and plugin.
Pros and cons
Pros
- Official, maintained by Stripe, with a hosted server so there is nothing to run locally.
- OAuth with per-environment permissions, and revocable sessions.
- Human confirmation for certain writes, plus admin controls and tool call logs in Workbench.
- Broad API coverage through a small set of tools, and built-in documentation search.
Cons
- Write access exists, so a mistaken or manipulated agent can act on real data if you grant it.
- Some tools and APIs are still in preview.
- The API key rules are changing on October 31, 2026, which affects older setups.
- It covers Stripe only. It is not a connector for other finance systems.
Who it is for
A good fit if:
- You run a business on Stripe and want an assistant to look up customers, charges, invoices and subscriptions or draft changes for you to confirm.
- You are building Stripe integrations and want the assistant to search the docs and API.
Not the right tool if:
- You need accounting, bank or brokerage data. Stripe's MCP docs do not list QuickBooks, Xero, PayPal, Plaid or market data, and the tools only touch the Stripe API.
- You want a strictly read-only connection. You can limit permissions, but the server itself includes write tools.
- For other payment or store data, compare the PayPal MCP server or the Shopify MCP server.
What we could not verify
- Whether the October 31, 2026 key rule applies to the local
@stripe/mcppackage. Stripe's docs say "Stripe MCP" without separating the hosted and local servers. - Pricing details. Stripe's MCP docs state no separate MCP fee; we did not confirm that with Stripe.
- Behavior of
npx @stripe/mcpwith no key. The package README says to pass--api-keyor setSTRIPE_SECRET_KEY; we did not run it. - Everything about how the tools behave in practice. We read the docs and package metadata and did not connect to a Stripe account.
How this page was put together
We read Stripe's MCP documentation (docs.stripe.com/mcp) and the npm entry for @stripe/mcp on September 30, 2026, including a check that the docs do not mention QuickBooks, Xero, PayPal, Plaid, brokerages or market data. Stripe changes this product often, so check the docs before you rely on a detail.
Sources
- Stripe docs: Model Context Protocol (MCP)
- npm: @stripe/mcp
- GitHub: stripe/ai (repository named in the package metadata, not read)
Pricing
Open Source: from Free to connect (Stripe account required; no separate MCP charge stated in Stripe's docs)
Our Take on Stripe MCP
The official route to a Stripe-aware assistant, and worth trying in a sandbox first. It is not read-only: it can write, so limit the permissions you grant and keep human confirmation on. It covers Stripe only, and Stripe is changing its API key rules on October 31, 2026.
Alternatives to Stripe MCP
Connect AI agents to your Shopify store for product, order, and cart operations
View Shopify MCP →