---
title: "Stripe MCP Server: Official Remote Setup and Agent Keys"
url: "https://mcpshelf.co/servers/stripe"
description: "Stripe's hosted MCP server lets an assistant search Stripe's docs and read or write customers, payments, invoices and subscriptions. OAuth and agent keys."
updated: "2026-11-10"
site: "MCP Shelf"
---

# Stripe MCP

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

Source: https://mcpshelf.co/servers/stripe  
Markdown: https://mcpshelf.co/servers/stripe.md  
Generated: 2026-11-22T13:57:58.832Z

## Facts

- **Name:** Stripe MCP
- **Tagline:** Stripe's own hosted server: its API and docs, behind OAuth and human confirmation.
- **Description:** 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.
- **Repository:** https://github.com/stripe/ai
- **Install:** `npm install -g @stripe/cli@latest && stripe agent setup`
- **Server URL:** https://mcp.stripe.com
- **Transport:** Streamable HTTP (remote)
- **Auth:** Needs `https://mcp.stripe.com`
- **Tools exposed:** 15: `stripe_api_search`, `stripe_api_details`, `stripe_api_read`, `stripe_api_write`, `get_stripe_account_info`, `search_stripe_documentation`, `stripe_implementation_planner`, `stripe_analytics`, `atlas_company_formation`, `get_balance_summary`, `setup_recipient`, `send_money`, `transfer_money`, `convert_currency`, `send_stripe_feedback`
- **Category:** Cloud and operations (https://mcpshelf.co/categories/cloud-and-ops)
- **Stats:** 2K GitHub stars, last commit 28 Oct 2026, 0 upvotes on MCP Shelf
- **Install check:** Needs your setup first
- **Listed:** 2026-11-10
- **Page updated:** 2026-11-10

## Full description

### 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.**

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) |
| GitHub | https://github.com/stripe/ai |
| Licence | MIT |
| GitHub stars | 2K |
| Last commit | 28 Oct 2026 |
| Tools | 15 |
| Runs on | Hosted |
| Install check | Needs your setup first |
| Category | [Cloud and operations](https://mcpshelf.co/categories/cloud-and-ops) |
| Works with | Claude Code, Cursor, Claude Desktop, VS Code, Codex, Windsurf, ChatGPT |
| Setup checked | 10 Nov 2026 |
| Page updated | 10 Nov 2026 |

**Our check:** It 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

- "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), tested on 10 Nov 2026

### What tools does Stripe MCP have?

We listed 15 tools on 10 Nov 2026. 8 only read; the rest can change things or run commands.

| Tool | Kind | What it is for |
| --- | --- | --- |
| `stripe_api_search` | reads | Finds the Stripe API method for a task from keywords, such as list failed payments. |
| `stripe_api_details` | reads | Returns the parameters for one API method, so the model calls it correctly. |
| `stripe_api_read` | reads | Calls any supported GET method: customers, charges, PaymentIntents, invoices, subscriptions, disputes, events, balance and more. |
| `stripe_api_write` | changes | 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. |
| `get_stripe_account_info` | reads | Reads the details of the connected Stripe account. |
| `search_stripe_documentation` | reads | Searches Stripe's docs and support articles for a question, in a chosen language. |
| `stripe_implementation_planner` | reads | Walks through which Stripe products fit what you are building, from one-off payments to billing, and how to integrate them. |
| `stripe_analytics` | reads | Preview: queries metrics, subscriptions and billing, and runs financial reports, writing the SQL from a plain-English question. |
| `atlas_company_formation` | changes | Prepares or resumes a Stripe Atlas application for a Delaware C corporation or LLC. You review, pay, sign and submit in the Dashboard. |
| `get_balance_summary` | reads | Treasury preview: shows a balance summary across your Stripe balance and Treasury accounts. |
| `setup_recipient` | changes | Treasury preview: sets up a recipient to send money to. |
| `send_money` | changes | Treasury preview: sends money from a Treasury account to a recipient, after you approve it. |
| `transfer_money` | changes | Treasury preview: moves money between supported Stripe balances, after you approve it. |
| `convert_currency` | changes | Treasury preview: converts funds between currencies in a Treasury account, after you approve it. |
| `send_stripe_feedback` | changes | Sends your feedback on Stripe's products to Stripe. |

#### Tool groups

| Group | Covers |
| --- | --- |
| `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. |

### How do I install Stripe MCP?

#### Install steps from the Stripe MCP README

Copied from the project's [README on GitHub](https://github.com/stripe/ai#readme) on 10 Nov 2026 under its MIT licence.

##### 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](https://docs.stripe.com/mcp#connect).

You can also [build autonomous agents](https://docs.stripe.com/mcp#agents) with MCP as well.

##### Agent skills

[Agent skills](https://agentskills.io/home) 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](https://cursor.com/marketplace/stripe).

###### 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](https://agent-plugins.org/) standard, but you can point your client to our package via:

- Git URL: `https://github.com/stripe/ai`
- Subdirectory: [`providers/agent-plugins/plugin/`](https://github.com/stripe/ai/blob/HEAD/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

#### Fastest way: one command

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

Stripe's recommended route. The Stripe CLI finds the agents you use and installs Stripe's plugin for each, which sets up this server and Stripe's skills and keeps them updated.

#### Claude Code

Where: Your terminal, in the project folder

```bash
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.

#### Cursor

Where: ~/.cursor/mcp.json, or .cursor/mcp.json in a project

```json
{
  "mcpServers": {
    "stripe": {
      "url": "https://mcp.stripe.com"
    }
  }
}
```

#### Claude Desktop

Where: Customize → Connectors → add a custom connector

```
https://mcp.stripe.com
```

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

#### VS Code

Where: .vscode/mcp.json in your project

```json
{
  "servers": {
    "stripe": {
      "type": "http",
      "url": "https://mcp.stripe.com"
    }
  }
}
```

#### Codex

Where: ~/.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.

#### Windsurf

Where: ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "stripe": {
      "serverUrl": "https://mcp.stripe.com"
    }
  }
}
```

#### ChatGPT

Where: chatgpt.com/plugins → + → Add custom MCP server

```
https://mcp.stripe.com
```

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

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

### How do I configure Stripe MCP?

| Setting | Kind | Required | What it does |
| --- | --- | --- | --- |
| `https://mcp.stripe.com` | config | yes | The hosted server. With OAuth you pick which live accounts and sandboxes the client may use, and its permissions in each. |
| `Authorization: Bearer` | config | no | 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. Example: `Authorization: Bearer YOUR_AGENT_API_KEY` |
| `Stripe-Account` | config | no | Header for Connect platforms that makes calls as one connected account. Works only with an agent API key, not OAuth. Example: `Stripe-Account: acct_123` |

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

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

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

### What are the alternatives to Stripe MCP?

| Server | What it does | Tools | Runs on | Licence | Stars |
| --- | --- | --- | --- | --- | --- |
| [Stripe MCP](https://mcpshelf.co/servers/stripe) | Stripe's own hosted server: its API and docs, behind OAuth and human confirmation. | 15 | Hosted | MIT | 2K |
| [AWS Knowledge MCP Server](https://mcpshelf.co/servers/aws-knowledge) | AWS's free hosted server for current AWS docs, API references and region checks. | 5 | Hosted | Apache-2.0 | 9.8K |
| [Cloudflare MCP Servers](https://mcpshelf.co/servers/cloudflare) | Cloudflare's own hosted servers, starting with a docs search that needs no sign-in. | 2 | Hosted | Apache-2.0 | 4.4K |
| [Grafana MCP](https://mcpshelf.co/servers/grafana) | Dashboards, metrics, logs, alerts and incidents from your Grafana, in one server. | 62 | Your computer | Apache-2.0 | 3.6K |
| [Azure DevOps MCP](https://mcpshelf.co/servers/azure-devops) | Microsoft's server for Azure DevOps boards, repos, pipelines, wikis and test plans. | 44 | Hosted or your computer | MIT | 2.1K |
| [Terraform MCP Server](https://mcpshelf.co/servers/terraform) | Current Terraform provider and module docs for your assistant, plus HCP Terraform if you want it. | 61 | Your computer or hosted | MPL-2.0 | 1.6K |

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

Full docs on GitHub: https://github.com/stripe/ai

## Notes for agents

Fetch these instead of parsing the HTML page:

- llms.txt: https://mcpshelf.co/llms.txt
- llms-full.txt: https://mcpshelf.co/llms-full.txt
- ai.txt: https://mcpshelf.co/ai.txt
- Full catalog (.md): https://mcpshelf.co/catalog.md
- API spec: https://mcpshelf.co/openapi.json
- MCP server: https://mcpshelf.co/mcp
- MCP manifest: https://mcpshelf.co/.well-known/mcp.json
- Developer docs: https://mcpshelf.co/developers

MCP endpoint (Streamable HTTP, no key): https://mcpshelf.co/mcp. REST API: https://mcpshelf.co/api/v1.

