▌BestMCPTools.org
Stripe MCP logo

Stripe MCP

Stripe's official MCP server for your Stripe account and docs

FinanceOpen SourceClaudeClaude CodeCursorVS CodeChatGPTCodexModerate✓ Verified

Last verified: September 30, 2026

Own Stripe MCP? Boost it to the top.✦ Upgrade to Featured

Maintenance status

Active
Last code update: September 28, 2026License: MITChecked September 28, 2026

How 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
MakerStripe
TypeHosted remote MCP server (recommended), plus a local npm package
Remote serverhttps://mcp.stripe.com
AuthenticationOAuth for interactive clients, or an agent API key sent as a bearer token for autonomous clients
Access modelRead and write; permissions come from the OAuth consent or the agent key; live mode and sandboxes are separate
ConfirmationStripe requires human approval for certain writes, such as refunds and outbound payments; approvals expire after 24 hours
Local optionnpx -y @stripe/mcp --api-key=YOUR_KEY (npm package 0.3.3, published March 24, 2026, MIT, Node.js 18 or newer)
Docsdocs.stripe.com/mcp
CostNo separate MCP charge is stated in Stripe's MCP docs. You need a Stripe account

What it does

Stripe's docs list these tools:

ToolWhat it does
stripe_api_searchFinds Stripe API methods by keyword
stripe_api_detailsReturns parameter details for one API method
stripe_api_readReads data with any Stripe API GET method
stripe_api_writeWrites data with any Stripe API POST, PATCH, PUT or DELETE method
get_stripe_account_infoRetrieves the account
stripe_analyticsPreview: queries metrics, analyzes subscriptions and billing and runs financial reports. Building SQL from natural language requires Sigma
get_balance_summaryPublic preview: interactive balance summary across the Stripe balance and Treasury accounts
search_stripe_documentationSearches Stripe's documentation
stripe_implementation_plannerGuides you through Stripe products for accepting payments, billing or another integration
send_stripe_feedbackSends 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

  1. Plugin (Stripe's recommended route): npm install -g @stripe/cli@latest, then stripe agent setup. It detects your agents and configures the MCP server and Stripe's skills.
  2. 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 using claude /mcp.
  3. Other clients: Cursor, VS Code, Codex and ChatGPT are covered in Stripe's docs. Any client can use https://mcp.stripe.com as the server URL.
  4. 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.
  5. 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_analytics and get_balance_summary are 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-Account header. Stripe's page does not say how this relates to the October 31 key change.
  • The local npm package is older. @stripe/mcp 0.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/mcp package. 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/mcp with no key. The package README says to pass --api-key or set STRIPE_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

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

PayPal MCPFinance

Create invoices, process payments, and manage orders via PayPal

View PayPal MCP →
Shopify MCPAPIs & Data

Connect AI agents to your Shopify store for product, order, and cart operations

View Shopify MCP →

Frequently Asked Questions

Tags