Stripe MCP Server (Official)Featured

What is Stripe MCP Server (Official)?

Stripe MCP Server (Official) is Stripe's hosted stripe mcp endpoint at https://mcp.stripe.com. It lets AI agents call the Stripe API, look up account data and search Stripe's documentation and support articles, using OAuth or an agent API key.

Stripe runs the server itself, so there is nothing to install. It uses a small set of generic tools (stripe_api_read, stripe_api_write and API search tools) to reach a long list of supported Stripe API methods without filling the model's context. Stripe also ships agent plugins and skills that configure the server for you.

How to use Stripe MCP Server (Official)?

Prerequisites: a Stripe account (live mode or a sandbox) and an MCP client that supports remote servers.

The quickest route, recommended by Stripe, is the Stripe CLI plugin setup. It detects the agents you use, configures the Stripe MCP server and installs Stripe's skills:

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

To set it up by hand, point your client at https://mcp.stripe.com.

Claude Code

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

Start Claude Code and run /mcp to sign in with OAuth. To use an agent API key instead, add the server to the project's .mcp.json and read the key from an environment variable:

{
  "mcpServers": {
    "stripe": {
      "type": "http",
      "url": "https://mcp.stripe.com",
      "headers": {
        "Authorization": "Bearer ${AGENT_API_KEY}"
      }
    }
  }
}

Claude Desktop

Install the official Stripe connector from the Claude directory, sign in to Stripe in the OAuth window, then enable Stripe under Connectors in a conversation. On Team and Enterprise plans an owner must add the connector to the workspace first.

Cursor

Use the "Install in Cursor" button in Stripe's docs, or add this to ~/.cursor/mcp.json:

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

VS Code

Add this to .vscode/mcp.json in your workspace:

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

Codex

codex mcp add stripe --url https://mcp.stripe.com

The ChatGPT desktop app, Codex CLI and Codex IDE extension share this configuration. For an agent API key, set bearer_token_env_var = "AGENT_API_KEY" under [mcp_servers.stripe] in the Codex config.

Authentication

• OAuth is for interactive clients. The consent page lets you grant access to one or more live mode accounts or sandboxes, with different permissions for each.
• Agent API keys are for autonomous clients. Create one with only the permissions the agent needs and send it as a bearer token in the Authorization header. Stripe says that from December 2026 the server stops accepting full-access secret keys and restricted keys without the Agent tag, so migrate by November 30, 2026.

Key features of Stripe MCP Server (Official)

• Official and hosted by Stripe; no local process or package to maintain
• Generic read and write tools cover a long list of supported API methods: customers, payments, refunds, invoices, subscriptions, products, prices, payment links, disputes, webhooks, tax and more
• Searches Stripe documentation and support articles
• OAuth with per-environment permissions, or scoped agent API keys
• Human confirmation for sensitive stripe_api_write actions such as refunds and outbound payments
• Connect support: act for connected accounts with the Stripe-Account header (agent API key only)
• Admin controls to turn MCP access on or off per environment and revoke OAuth sessions

Stripe MCP Server (Official) tools

• API tools: stripe_api_search finds API methods by keyword, stripe_api_details returns a method's parameters, stripe_api_read runs GET methods and stripe_api_write runs POST, PATCH, PUT and DELETE methods.
• Account and analytics: get_stripe_account_info retrieves the account; stripe_analytics (preview) queries metrics and financial reports, and builds SQL from natural language when Sigma is enabled.
• Treasury (public preview): get_balance_summary, convert_currency, send_money, setup_recipient and transfer_money.
• Guidance: search_stripe_documentation, stripe_implementation_planner for planning an integration, atlas_company_formation for Stripe Atlas, and send_stripe_feedback.

Use cases of Stripe MCP Server (Official)

• Customer support: "Find the customer jane@example.com and show her last three charges."
• Billing operations: "Create a monthly price of $20 for the Pro product and a payment link for it."
• Refunds with a safety check: ask for a refund, then approve it at the confirmation URL Stripe returns.
• Revenue questions: "What was our MRR last month?" through stripe_analytics.
• Integration planning: "How should I set up subscriptions with a free trial?" answered from Stripe docs.
• Connect platforms: investigate a payment on a specific connected account.

Stripe MCP Server (Official) vs alternatives

The hosted server is the official option, and Stripe's stripe/ai repository points to it for MCP. Some community Stripe MCP servers on mcp.so, such as this Stripe MCP Server, run locally with your own Stripe secret key in an environment variable. They are not maintained by Stripe and do not offer the hosted server's OAuth sign-in or human confirmation for sensitive writes. For other payment providers, PayPal maintains its own PayPal MCP Server.

Troubleshooting Stripe MCP Server (Official)

• 401 with an OAuth challenge: the server no longer accepts your key type. Reconnect with OAuth or create an agent API key.
• Can't connect on a work machine: managed networks may block external MCP servers. Ask IT to allow mcp.stripe.com.
• MCP disabled for your team: an administrator can turn MCP access on for live mode and sandboxes in Dashboard settings.
• Write action waiting: some writes need human approval. Open the URL the agent gives you, click Approve, then tell the agent to retry. Approvals expire after 24 hours.
• Connected account calls fail with OAuth: Connect requires an agent API key plus the Stripe-Account header.