# mcp — MCP server card for AI agents

MCP server integrating with Stripe - tools for customers, products, payments, and more.

Registry name: `com.stripe/mcp` · category: Commerce and payments · version 0.2.4 · updated 2025-10-28

## Connect
- Remote (Claude Code): `claude mcp add --transport http mcp https://mcp.stripe.com`

## Facts
- Repository: https://github.com/stripe/agent-toolkit (2,072 stars)

Before you connect a server: read its repository, and give it only the permissions and keys it needs.

## Links
- AgentGid page: https://agentgid.com/mcp/servers/com-stripe-mcp/


## Stripe MCP: your AI assistant works in your Stripe account

Stripe's own hosted server lets an AI assistant such as Claude, Cursor or Codex look things up and make changes in your Stripe account. It can find customers and payments, create products, prices and payment links, issue refunds and search Stripe's docs. You sign in to Stripe once and choose what it may do.

### Where to use it
- Look up a customer or payment for support: A support helper finds the customer, the payment and its refunds while answering a ticket. On a platform it can do this for one of your connected seller accounts.
- Questions about revenue and refunds: Ask in plain words how a promotion changed revenue this quarter, or why refunds went up last week. Read-only rights are enough, so nothing in the account changes.
- Set up a new product to sell: Have your assistant create the product, its price and a payment link you can share, without clicking through the dashboard. Try it in a test account first.
- Refund an order with your approval: The assistant prepares the refund, and Stripe asks you to approve it in the dashboard before any money goes back.
- Plan a Stripe setup while coding: While your coding assistant builds checkout or subscriptions, it can search Stripe's docs and get a step-by-step plan for your case.
- Draft a company sign-up with Stripe Atlas: The assistant fills in a draft Atlas application for a Delaware company. You still review, pay, sign and submit it yourself in the dashboard.

### How to start
- Add the hosted server to Claude Code with one command (Cursor, Codex and VS Code have their own lines on the same page).

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

- Start Claude Code, run /mcp and sign in to Stripe. Pick a sandbox or live account and the permissions for each.
- For an assistant that runs on its own without a sign-in window, create an agent API key with only the permissions it needs and pass it from an environment variable.

### License
Stripe runs the server; it is free to connect, and the work it does in your account follows your normal Stripe account and fees. The plugins and skills in Stripe's public code folder are under the MIT license.

### Good to know
- One tool can create, change and delete almost anything the server supports, from coupons to subscriptions. Turn on your assistant's approval prompt so you see each call first.
- Some tools move real money, such as sending or converting funds in a Treasury account. Stripe asks a person to confirm those in the dashboard.
- From December 2026 the server stops taking full-access secret keys and untagged restricted keys. Use sign-in or a new agent key.
- The old local package @stripe/mcp is retired and gets no more fixes. Connect to the hosted address instead.
- The data questions use Stripe's Queries service, which is free until January 31, 2027; paid usage starts February 1, 2027.

Checked 2026-11-10 against: https://docs.stripe.com/mcp.md, https://docs.stripe.com/keys.md, https://docs.stripe.com/atlas/agents.md, https://docs.stripe.com/data/analyze-with-ai.md, https://github.com/stripe/ai/blob/d8e14797c726086c4376f576f6fb7cbb908e5f15/README.md, https://github.com/stripe/ai/blob/d8e14797c726086c4376f576f6fb7cbb908e5f15/tools/README.md, https://github.com/stripe/ai/blob/d8e14797c726086c4376f576f6fb7cbb908e5f15/LICENSE, https://mcp.stripe.com/

### Mistakes to avoid
- Don't: npx -y @stripe/mcp --tools=all --api-key=sk_live_... (the local package) → Do: Connect to the hosted server: claude mcp add --transport http stripe https://mcp.stripe.com/ (The local proxy is retired and gets no more updates or security fixes.)
- Don't: Authorization Bearer with a full-access secret key (sk_live_...) → Do: Sign in with OAuth, or create an agent API key with only the needed permissions (The server stops accepting full-access and untagged restricted keys from December 2026 and answers 401.)
- Don't: Pass the key on the command line or paste it into the chat → Do: Put it in an environment variable and reference it from .mcp.json as ${AGENT_API_KEY} (Stripe's docs reference an env var instead of the key itself.)
- Don't: Assume the refund went through after the person clicked Approve → Do: After approval, call the same write again; Stripe then accepts it with the approval token (Approval returns a token, the agent must retry the operation.)
- Don't: Use OAuth to act for a connected account on a platform → Do: Use the platform's agent API key plus the Stripe-Account header (OAuth is not supported for connected accounts.)

### Questions
- Do I need to install anything? No package. Add the address https://mcp.stripe.com in your assistant and sign in to Stripe; the old local package is retired.
- Can the assistant refund money without me? Refunds and Treasury money moves need your approval in the Stripe dashboard. After you approve, tell the assistant to retry; an approval expires after 24 hours.
- Can I try it without touching real payments? Yes. When you sign in you can give access to a sandbox, a test copy of your account where no real payments are processed.
- How do I cut off an assistant's access? Revoke its session under OAuth sessions in your Stripe user settings; admins can do it for team members.
- My company network blocks the connection. What now? Ask your IT team to allow mcp.stripe.com.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
