
Stripe MCP Server
Stripe's own hosted server: its API and docs, behind OAuth and human confirmation.
- 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
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).
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.
| Tool | What it is for |
|---|---|
atlas_company_formation | Prepares or resumes a Stripe Atlas application for a Delaware C corporation or LLC. You review, pay, sign and submit in the Dashboard. |
convert_currency | Treasury preview: converts funds between currencies in a Treasury account, after you approve it. |
send_money | Treasury preview: sends money from a Treasury account to a recipient, after you approve it. |
send_stripe_feedback | Sends your feedback on Stripe's products to Stripe. |
setup_recipient | Treasury preview: sets up a recipient to send money to. |
stripe_api_write | Calls 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_money | Treasury preview: moves money between supported Stripe balances, after you approve it. |
Only reads8 tools · Looks things up and changes nothing.
| Tool | What it is for |
|---|---|
get_balance_summary | Treasury preview: shows a balance summary across your Stripe balance and Treasury accounts. |
get_stripe_account_info | Reads the details of the connected Stripe account. |
search_stripe_documentation | Searches Stripe's docs and support articles for a question, in a chosen language. |
stripe_analytics | Preview: queries metrics, subscriptions and billing, and runs financial reports, writing the SQL from a plain-English question. |
stripe_api_details | Returns the parameters for one API method, so the model calls it correctly. |
stripe_api_read | Calls any supported GET method: customers, charges, PaymentIntents, invoices, subscriptions, disputes, events, balance and more. |
stripe_api_search | Finds the Stripe API method for a task from keywords, such as list failed payments. |
stripe_implementation_planner | Walks 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:
npm install -g @stripe/cli@latest && stripe agent setupOr paste it into your app by hand:
Where it goes: Your terminal, in the project folder
claude mcp add --transport http stripe https://mcp.stripe.comclaude 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.
Where it goes: ~/.cursor/mcp.json, or .cursor/mcp.json in a project
{
"mcpServers": {
"stripe": {
"url": "https://mcp.stripe.com"
}
}
}Where it goes: Customize → Connectors → add a custom connector
https://mcp.stripe.comStripe has an official connector in Claude's directory, for Claude on the web and Claude Desktop. Add it, sign in to Stripe, then turn Stripe on under Connectors in a chat.
Where it goes: .vscode/mcp.json in your project
{
"servers": {
"stripe": {
"type": "http",
"url": "https://mcp.stripe.com"
}
}
}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:
- Git URL:
https://github.com/stripe/ai - Subdirectory:
providers/agent-plugins/plugin/.
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 mcp add --transport http stripe https://mcp.stripe.comclaude 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.
Where it goes: ~/.cursor/mcp.json, or .cursor/mcp.json in a project
{
"mcpServers": {
"stripe": {
"url": "https://mcp.stripe.com"
}
}
}Where it goes: Customize → Connectors → add a custom connector
https://mcp.stripe.comStripe has an official connector in Claude's directory, for Claude on the web and Claude Desktop. Add it, sign in to Stripe, then turn Stripe on under Connectors in a chat.
Where it goes: .vscode/mcp.json in your project
{
"servers": {
"stripe": {
"type": "http",
"url": "https://mcp.stripe.com"
}
}
}Where it goes: ~/.codex/config.toml, shared by the Codex CLI, IDE extension and ChatGPT desktop app
[mcp_servers.stripe]
url = "https://mcp.stripe.com"codex mcp add stripe --url https://mcp.stripe.com. For an agent API key, set bearer_token_env_var to the name of the environment variable that holds it.
Where it goes: ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"stripe": {
"serverUrl": "https://mcp.stripe.com"
}
}
}Where it goes: chatgpt.com/plugins → + → Add custom MCP server
https://mcp.stripe.comInstall Stripe's official plugin in ChatGPT and sign in to Stripe in the window that opens.
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.
| Setting | What it does |
|---|---|
https://mcp.stripe.comConfig · required | The hosted server. With OAuth you pick which live accounts and sandboxes the client may use, and its permissions in each. |
Authorization: BearerConfig | Header 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-AccountConfig | Header 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'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'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

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

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

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
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