Skip to content
MCP Shelf

Stripe MCP Server

Stripe's own hosted server: its API and docs, behind OAuth and human confirmation.

View on GitHub
  • Needs your setup first
  • ★ 2K GitHub stars
  • Last commit 28 Oct 2026

What is Stripe MCP?

Stripe MCP is Stripe's official hosted server that lets an AI assistant search Stripe's API and docs and read or change customers, payments, invoices and subscriptions, behind OAuth.

Tools
15
Runs on
Hosted
Licence
MIT
GitHub stars
2K

Good for

  • Looking up a customer, payment or failed invoice without opening the Dashboard
  • Setting up products, prices and payment links in a sandbox while you build
  • Getting Stripe-correct integration code with the docs search and implementation planner

You'll need

  • A Stripe account; a sandbox is the place to start
  • A client that supports remote servers and OAuth, or an agent API key for one that does not
Works withClaude CodeCursorClaude DesktopVS CodeCodexWindsurfChatGPTEach has a ready-made config on the Install tab, built from the README.

Needs your setup firstIt needs something our Linux test machine does not have (an account, a desktop app, a Mac or a running service), so on 10 Nov 2026 we read its tools from the source code instead of running this config. The stripe/agent-toolkit repository is now stripe/ai, and its README says @stripe/mcp and @stripe/agent-toolkit are deprecated. Nothing to install: Stripe hosts the server.

Try asking Stripe MCP

Once it is installed, ask your assistant things like:

  • What was my revenue last month, and how does it compare with the month before?
  • Find the customer with this email and show their recent payments.
  • How do I set up a subscription with a free trial? Check the Stripe docs.

MCP Shelf take

Stripe needs something our Linux test machine does not have (an account, an app or a service), so on 10 Nov 2026 we read its source and counted 15 tools. 8 of the 15 only read; the other 7 can change things. It sits 5th of 6 in its category on our shelf by GitHub stars (2K).
MCP Shelf tests: numbers from our own runs, not the README · tested on 10 Nov 2026

What can Stripe MCP read and change?

It can read

  • Customers, payments, charges, refunds, invoices, subscriptions, products and prices
  • Disputes, payouts and balances, events, webhooks and tax settings
  • Stripe's documentation and support articles

It can change

  • Customers, products, prices, coupons, payment links, invoices and subscriptions
  • Refunds and Treasury transfers, each only after you approve it in the Dashboard
  • Webhook endpoints, portal settings and tax registrations

Safer setup: Grant only a sandbox in the OAuth window, or use an agent API key with only the permissions it needs. Turn on your client's tool approval so you see each call, and take care running it alongside other servers, as Stripe warns about prompt injection.

Stripe MCP in more detail

Stripe runs this server at mcp.stripe.com. Rather than one tool per endpoint, it gives the model a small set: search the API for the right method, read its parameters, then call it through one read tool for GET requests and one write tool for the rest. That reaches customers, payments, refunds, invoices, subscriptions, products and prices, payment links, disputes, webhooks and more, plus Stripe's documentation search and an implementation planner.

You connect with OAuth and choose which accounts, live or sandbox, it may use and with what permissions. Some actions, such as refunds and Treasury transfers, also need you to approve them in the Dashboard before they go through. Stripe's old local packages, @stripe/mcp and the agent toolkit, are deprecated in favour of this hosted server.

Made by
Stripe (stripe/ai)
Last commit
28 Oct 2026
Setup checked
10 Nov 2026
Page updated
10 Nov 2026

What's in the pod

What tools does Stripe MCP have?

We found 15 tools in its source code on 10 Nov 2026. 8 only read. The rest can change things, so keep your app's "ask before each tool call" setting on for them.

How we tested it: Taken from Stripe's tool reference at docs.stripe.com/mcp. The server needs a Stripe sign-in or an agent API key.

Changes things7 tools · Can create, edit, send or delete.

ToolWhat it is for
atlas_company_formationPrepares or resumes a Stripe Atlas application for a Delaware C corporation or LLC. You review, pay, sign and submit in the Dashboard.
convert_currencyTreasury preview: converts funds between currencies in a Treasury account, after you approve it.
send_moneyTreasury preview: sends money from a Treasury account to a recipient, after you approve it.
send_stripe_feedbackSends your feedback on Stripe's products to Stripe.
setup_recipientTreasury preview: sets up a recipient to send money to.
stripe_api_writeCalls any supported POST, PATCH, PUT or DELETE method, such as creating a customer, price or payment link, or cancelling a subscription. Refunds need your approval in the Dashboard.
transfer_moneyTreasury preview: moves money between supported Stripe balances, after you approve it.

Only reads8 tools · Looks things up and changes nothing.

ToolWhat it is for
get_balance_summaryTreasury preview: shows a balance summary across your Stripe balance and Treasury accounts.
get_stripe_account_infoReads the details of the connected Stripe account.
search_stripe_documentationSearches Stripe's docs and support articles for a question, in a chosen language.
stripe_analyticsPreview: queries metrics, subscriptions and billing, and runs financial reports, writing the SQL from a plain-English question.
stripe_api_detailsReturns the parameters for one API method, so the model calls it correctly.
stripe_api_readCalls any supported GET method: customers, charges, PaymentIntents, invoices, subscriptions, disputes, events, balance and more.
stripe_api_searchFinds the Stripe API method for a task from keywords, such as list failed payments.
stripe_implementation_plannerWalks through which Stripe products fit what you are building, from one-off payments to billing, and how to integrate them.

Tool groups

API tools
Search, details, read and write: about 110 Stripe API methods across customers, charges, refunds, PaymentIntents and SetupIntents, Checkout Sessions, invoices and credit notes, subscriptions and schedules, coupons and promotion codes, products and prices, payment links, disputes, webhooks and event destinations, the customer portal, tax and balances.
Docs and planning
search_stripe_documentation and stripe_implementation_planner, which need no account data.
Analytics, Atlas and Treasury
stripe_analytics, Atlas company formation and the Treasury money tools, several in preview, with Dashboard confirmation for anything that moves money.

Grouped and described by us. The README on GitHub lists the inputs each tool takes.

How do I install Stripe MCP?

Quick install

One command from the README sets it up for you:

Terminal
npm install -g @stripe/cli@latest && stripe agent setup

Or paste it into your app by hand:

Where it goes: Your terminal, in the project folder

Claude Code
claude mcp add --transport http stripe https://mcp.stripe.com

claude mcp add --transport http stripe https://mcp.stripe.com/, then run /mcp in Claude Code to sign in. Or install Stripe's plugin: claude plugin install stripe@claude-plugins-official.

Codex, Windsurf, ChatGPT and more →

Install steps from the Stripe MCP README

The project's own instructions, copied from its README on GitHub on 10 Nov 2026 under its MIT licence. They are the source of truth; the ready-made configs further down are built from them. The full README is on GitHub.

Model Context Protocol (MCP)

Stripe hosts a remote MCP server at https://mcp.stripe.com. This allows secure MCP client access via OAuth. View the docs here.

You can also build autonomous agents with MCP as well.

Agent skills

Agent skills are instructions that agents can use to build faster and more accurately. Stripe offers a collection of skills that help your agents use the latest best practices when building with Stripe.

If you use one of these popular agent harnesses, we recommend installing the official Stripe plugins, which include additional agent tools and update automatically.

Claude Code

Run this command in your project:

claude plugin install stripe@claude-plugins-official
Codex

Run this command in your project:

codex plugin add stripe@openai-curated
Cursor

Run this command in your project:

/add-plugin stripe

You can also install through the Cursor marketplace.

Grok Build

Run this command in your project:

grok plugin install stripe --trust
Agent Plugins

Installation methods currently vary by client for the new Agent Plugins standard, but you can point your client to our package via:

What you need first

  • A Stripe account; a sandbox is the place to start
  • A client that supports remote servers and OAuth, or an agent API key for one that does not

Add Stripe MCP to your app

Pick your app for a ready-to-paste snippet and where it goes, built from the steps above.

Where it goes: Your terminal, in the project folder

Claude Code
claude mcp add --transport http stripe https://mcp.stripe.com

claude mcp add --transport http stripe https://mcp.stripe.com/, then run /mcp in Claude Code to sign in. Or install Stripe's plugin: claude plugin install stripe@claude-plugins-official.

Sign in through the OAuth window your client opens and grant a sandbox first. From December 2026 Stripe only accepts agent API keys, not ordinary secret keys, as a bearer token.

Step-by-step guides for Stripe MCP

Longer walk-throughs for one app at a time: sign-in, scopes, trimming the tools, and that app's own errors.

Checked against the project's own install docs on 10 Nov 2026: stripe/ai README, docs.stripe.com/mcp.

Did this work for you?

Projects change their install steps often. If Stripe MCP did not install, or something here no longer matches the project, tell us and we will check it against the README and fix the page.

New to this? See the setup guides for Claude Code, Cursor, Claude Desktop, VS Code, Codex and ChatGPT. If it will not start, test it in MCP Inspector and look up the error in Fixing MCP server errors.

Stripe MCP not working? Common fixes

Requests fail with 401 after November 2026
Stripe stopped accepting full-access secret keys and untagged restricted keys. Create an agent API key in the Dashboard, or reconnect with OAuth.
A refund or Treasury transfer never goes through
Those need human confirmation. Open the link the agent gives you, approve it in the Dashboard within 24 hours, then tell the agent to retry.
The server will not connect on a work laptop
Company networks and managed devices can block outside MCP servers. Ask IT to allow mcp.stripe.com.
It cannot act for my Connect platform's connected accounts
OAuth does not cover connected accounts. Use a platform agent API key with connected-account permissions and send the Stripe-Account header.
My team cannot connect at all
An administrator can turn MCP access on or off for the whole team, separately for live mode and sandboxes, under MCP and CLI access in the Dashboard settings.

How do I configure Stripe MCP?

Names are exactly as the project spells them. Required ones are marked.

SettingWhat it does
https://mcp.stripe.comConfig · requiredThe hosted server. With OAuth you pick which live accounts and sandboxes the client may use, and its permissions in each.
Authorization: BearerConfigHeader for an agent API key, for clients that cannot do OAuth or agents that run on their own. From December 2026 ordinary secret keys and restricted keys without the Agent tag are refused with a 401.Authorization: Bearer YOUR_AGENT_API_KEY
Stripe-AccountConfigHeader for Connect platforms that makes calls as one connected account. Works only with an agent API key, not OAuth.Stripe-Account: acct_123

Stripe MCP FAQ

Is Stripe MCP official?

Yes. Stripe runs the server at mcp.stripe.com and documents it at docs.stripe.com/mcp. Its plugins and skills live in the stripe/ai repository on GitHub, under the MIT licence.

How do I add Stripe MCP to Claude Code?

Run claude mcp add --transport http stripe https://mcp.stripe.com/ and then /mcp to sign in with OAuth. Stripe's plugin, claude plugin install stripe@claude-plugins-official, adds the server and Stripe's skills together.

What happened to @stripe/mcp and the agent toolkit?

Both are deprecated and get no more updates, not even security fixes. Stripe now points everyone to the hosted server, which needs no install.

Can the assistant issue refunds or move money?

It can ask to, but Stripe holds refunds and Treasury transfers until you approve them in the Dashboard through the link the agent shows. Unapproved requests expire after 24 hours.

Should I use OAuth or an API key?

OAuth for an assistant you use yourself, as you can grant a sandbox and revoke it any time. An agent API key, with only the permissions it needs, for an agent that runs on its own.

Can I try it without touching live payments?

Yes. In the OAuth window grant only a sandbox, and the server can only see and change test data there.

Why are there so few tools for the whole Stripe API?

Stripe gives the model a search tool and generic read and write tools instead of one tool per endpoint. That reaches more than a hundred API methods without filling the context window.

What does Stripe MCP cost?

The server is free with a Stripe account. You pay Stripe's usual fees for any payments it creates, and Atlas or Treasury features cost what they normally do.

How do I add Stripe MCP to Cursor?

In ~/.cursor/mcp.json, or .cursor/mcp.json for one project, add an entry named stripe with the URL https://mcp.stripe.com. Save, and sign in in the browser if Cursor asks.

Can I use Stripe MCP in VS Code?

Yes, through GitHub Copilot. In .vscode/mcp.json, add a server named stripe with type http and the URL https://mcp.stripe.com. Then switch Copilot Chat to Agent mode to use its tools.

Does Stripe MCP work with Codex?

Yes. Run codex mcp add stripe --url https://mcp.stripe.com in a terminal, or add an [mcp_servers.stripe] table to ~/.codex/config.toml, which the Codex CLI and IDE extension share. For an agent API key, set bearer_token_env_var to the name of the environment variable that holds it.

Two peas, one chat

Chat with AI about Stripe

Opens a chat primed with Stripe’s README and setup docs from this page, or add it in Cursor to use its tools.

The Cursor button opens Cursor and asks before it adds the server. Fill in any keys it needs in Cursor’s MCP settings.

Peas in a pod

What are the alternatives to Stripe MCP?

How Stripe MCP lines up against its neighbours on the shelf. See every cloud and operations server.

  • Stripe MCPThis pea

    Stripe's own hosted server: its API and docs, behind OAuth and human confirmation.

    Tools
    15
    Runs on
    Hosted
    Licence
    MIT
    Stars
    2K
  • AWS Knowledge MCP Server

    AWS's free hosted server for current AWS docs, API references and region checks.

    Tools
    5
    Runs on
    Hosted
    Licence
    Apache-2.0
    Stars
    9.8K
  • Cloudflare MCP Servers

    Cloudflare's own hosted servers, starting with a docs search that needs no sign-in.

    Tools
    2
    Runs on
    Hosted
    Licence
    Apache-2.0
    Stars
    4.4K
  • Grafana MCP

    Dashboards, metrics, logs, alerts and incidents from your Grafana, in one server.

    Tools
    62
    Runs on
    Your computer
    Licence
    Apache-2.0
    Stars
    3.6K
  • Azure DevOps MCP

    Microsoft's server for Azure DevOps boards, repos, pipelines, wikis and test plans.

    Tools
    44
    Runs on
    Hosted or your computer
    Licence
    MIT
    Stars
    2.1K
  • Terraform MCP Server

    Current Terraform provider and module docs for your assistant, plus HCP Terraform if you want it.

    Tools
    61
    Runs on
    Your computer or hosted
    Licence
    MPL-2.0
    Stars
    1.6K
Full docs on GitHubstripe/ai

Something wrong on this page? Tell us.

For bots & AI agents

Machine-readable versions of Stripe MCP and MCP Shelf. Fetch these instead of parsing this page.

This listing (.md)llms.txtllms-full.txtai.txtFull catalog (.md)API specMCP serverMCP manifestDeveloper docs