Stripe

Stripe MCP server

Connect AI agents to Stripe over MCP: search and call the Stripe API, analytics, docs search, with OAuth or agent keys.

PaymentsGuided#mcp#payments#billing#ai-agents#oauth

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Stripe's remote MCP server at https://mcp.stripe.com lets AI agents work with your Stripe account and search Stripe's knowledge base. Instead of one tool per endpoint it exposes a small set of generic tools: stripe_api_search finds the right API method, stripe_api_details explains its parameters, stripe_api_read runs any supported GET method and stripe_api_write runs supported POST, PATCH, PUT and DELETE methods (customers, payments, refunds, invoices, subscriptions, products, prices, payment links, disputes, payouts, tax and more; the full list is on the docs page). Around those sit account, analytics, Treasury, Atlas and documentation tools.

Credentials (two options)

  1. OAuth (interactive clients). Without credentials the server returns 401 with WWW-Authenticate: Bearer resource_metadata="https://mcp.stripe.com/.well-known/oauth-protected-resource" and the JSON error missing_api_key (checked live). The metadata names https://access.stripe.com/mcp as the authorization server (authorize, token, dynamic registration and revocation endpoints, PKCE S256, scope mcp). On Stripe's consent page you choose which live accounts or sandboxes the client may use, with separate permissions for each. Folder 1 shows these calls.
  2. Agent API key (this collection's default). For clients that cannot do OAuth, create an agent API key in the Dashboard (it shows an Agent badge) with only the permissions the agent needs, ideally in a sandbox first, and send it as Authorization: Bearer .... Paste it into the secret agentApiKey variable. Stripe says that from December 2026 the MCP server stops accepting full-access secret keys and restricted keys without the Agent tag, so migrate before 30 November 2026.

Admins can switch MCP access on or off for the whole team (Dashboard > Settings > MCP and CLI access, separately for live and sandbox). Users revoke clients under OAuth sessions in their user settings.

Add it to your AI client

  • Claude Code: claude mcp add --transport http stripe https://mcp.stripe.com/ then /mcp to sign in; or put "headers": {"Authorization": "Bearer ${AGENT_API_KEY}"} in .mcp.json.
  • Claude Desktop / claude.ai: install the official Stripe connector from the Claude directory, then sign in to Stripe in the OAuth window.
  • Cursor (~/.cursor/mcp.json): {"mcpServers": {"stripe": {"url": "https://mcp.stripe.com"}}}.
  • VS Code (.vscode/mcp.json): {"servers": {"stripe": {"type": "http", "url": "https://mcp.stripe.com"}}}.
  • Stripe also offers stripe agent setup (Stripe CLI) to configure supported agents automatically.

Run order

Fill agentApiKey (sandbox key), run folder 2 (raw tools/list shows every tool's exact input schema), then folder 3 (account and docs), folder 4 (API tools) and folder 5 (analytics and treasury). Stripe documents the tool names but not their argument schemas, so tools that need arguments are saved with an empty argument object: fill them from the schema the app shows after connecting, or from tools/list.

ToolUse
get_stripe_account_infoWhich account the key belongs to
search_stripe_documentationSearch docs and support articles
stripe_api_search, stripe_api_detailsFind an API method and its parameters
stripe_api_read, stripe_api_writeCall supported GET / write methods
stripe_analyticsMetrics, reports and SQL from natural language (preview)
get_balance_summary, send_money, transfer_money, convert_currency, setup_recipientTreasury (public preview)
stripe_implementation_planner, atlas_company_formation, send_stripe_feedbackPlanning, Atlas, feedback

Safety

stripe_api_write can create refunds, cancel subscriptions, void invoices and more; Treasury tools move money. Stripe adds a human confirmation step for some actions (creating refunds, send_money, transfer_money, convert_currency): the agent gives you a Dashboard link and nothing happens until you approve it. Still turn on your client's tool approval, use sandboxes and narrowly scoped agent keys, and be careful mixing Stripe MCP with other servers that could inject instructions. Rate limits are Stripe's API limits (docs).

Common errors

ResponseMeaningFix
401 missing_api_keyNo key or tokenFill agentApiKey or sign in with OAuth
401/403 with a keyKey not an agent key (after Nov 2026) or lacks permissionCreate an agent key with the needed permissions
Tool result asks for confirmationHuman confirmation requiredOpen the link and approve in the Dashboard
Connection blockedManaged network blocks MCPAsk IT to allow mcp.stripe.com

Docs: Stripe MCP, agent keys, agent plugins.

Endpoints 15

1. Start here: auth discovery

  • POSTCall the server without a key (expect 401){{mcpUrl}}Sends an MCP initialize request with no Authorization header. Stripe answers 401 with a missing_api_key error and a WWW-Authenticate header that points…
  • GETProtected resource metadata{{mcpUrl}}/.well-known/oauth-protected-resourceReads the OAuth protected-resource document: the resource URL, the single scope mcp and the authorization server at access.stripe.com/mcp that issues tokens…
  • GETAuthorization server metadatahttps://access.stripe.com/.well-known/oauth-authorization-server/mcpReads the OAuth server metadata: authorize, token, dynamic registration and revocation endpoints, public clients with PKCE S256, and the authorization_code…

2. Wire protocol

  • POSTInitialize (raw JSON-RPC){{mcpUrl}}Runs the MCP initialize handshake with your agent API key and shows the protocol version, server info and capabilities. If an Mcp-Session-Id header comes…
  • POSTList tools (raw JSON-RPC){{mcpUrl}}Calls tools/list and returns every tool available to your key with its description and JSON input schema. Use it to fill in the arguments of the saved tool…

3. Account and documentation

  • MCPGet account info{{mcpUrl}}Calls get_stripe_account_info, which returns the connected account's id, display name and a link to the Dashboard API keys page. Run it first to confirm which…
  • MCPSearch Stripe documentation{{mcpUrl}}Calls search_stripe_documentation to search Stripe docs and support articles for a question in a given language, returning relevant passages and links. Useful…
  • MCPPlan an integration{{mcpUrl}}Calls stripe_implementation_planner, which walks you through which Stripe products and integration path fit what you are building (accepting payments, selling…

4. API tools

  • MCPSearch API methods{{mcpUrl}}Calls stripe_api_search with a keyword (for example 'list customers' or 'refund') and returns matching Stripe API methods, which you then pass to…
  • MCPGet API method details{{mcpUrl}}Calls stripe_api_details for one API method found with stripe_api_search and returns its parameters, types and which are required, so the agent can build a…
  • MCPRead with a GET method{{mcpUrl}}Calls stripe_api_read to run a supported GET method, for example list customers, retrieve a PaymentIntent, list invoices or retrieve the balance. Safe to run:…
  • MCPWrite with a POST/DELETE method{{mcpUrl}}Calls stripe_api_write to run a supported write method such as create a customer, create a payment link, update a subscription or create a refund. This…

5. Analytics and Treasury (preview)

  • MCPAsk analytics a question{{mcpUrl}}Calls stripe_analytics (preview) to find metrics and reports or turn a natural language question, such as MRR by month, into a query over your Stripe data.…
  • MCPBalance summary{{mcpUrl}}Calls get_balance_summary (Treasury, public preview) to show an interactive summary of your Stripe balance and Treasury accounts. Read-only; may need Treasury…
  • MCPSend money (needs confirmation){{mcpUrl}}Calls send_money (Treasury, public preview) to pay a recipient from a Treasury account. Stripe holds the request until you approve it in the Dashboard through…

API details

Base URL
https://mcp.stripe.com
Authentication
A bearer token in the Authorization header
OAuth 2.0 (authorization code flow) with 1 scope
Operations
15 operations on 15 pathsPOST 13GET 2
Main resources
1. Start here: auth discovery 32. Wire protocol 23. Account and documentation 34. API tools 45. Analytics and Treasury (preview) 3
Description format
Swastik Codes guided collection, API version checked against the docs on 2026-11-18

How to test the Stripe MCP server in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Stripe MCP server collection, without the publisher's secrets.
  3. Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Call the server without a key (expect 401)” (POST {{mcpUrl}}), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Stripe MCP server?

Connect AI agents to Stripe over MCP: search and call the Stripe API, analytics, docs search, with OAuth or agent keys. It is listed under Payments and has 15 endpoints.

Who publishes the Stripe MCP server?

It is listed from Stripe's public API description (an OpenAPI document), not published by Stripe on Swastik Codes. Anyone who controls stripe.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Stripe MCP server?

Requests go to https://mcp.stripe.com. Endpoint paths are added to this base URL.

How do I authenticate with the Stripe MCP server?

It accepts 2 methods: A bearer token in the Authorization header; OAuth 2.0 (authorization code flow) with 1 scope.

How many endpoints does the Stripe MCP server have?

15 operations on 15 paths (13 POST, 2 GET). The largest groups are 1. Start here: auth discovery, 2. Wire protocol, 3. Account and documentation, 4. API tools.

Is forking the Stripe MCP server free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.