# Model Context Protocol (MCP) Let your AI agents interact with the Stripe API by using our MCP server. The Stripe Model Context Protocol (MCP) server provides tools that AI agents can use to interact with the Stripe API and search Stripe’s knowledge base, including documentation and support articles. ## Set up Stripe MCP with a plugin (Recommended) [Agent plugins](https://docs.stripe.com/agents/plugin.md) for Stripe automatically configure the Stripe MCP server, install our [skills](https://docs.stripe.com/skills.md) and make sure they’re up-to-date. You get our latest capabilities without configuration or maintenance. To install, run: ```bash npm install -g @stripe/cli@latest stripe agent setup ``` This command automatically detects which agents you use, and runs the applicable commands. ## Manually set up Stripe MCP If your MCP client doesn’t support [agent plugins](https://docs.stripe.com/agents/plugin.md) for Stripe, or you prefer to configure the Stripe MCP server and install the skills manually, follow these instructions: #### Cursor [Install in Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=stripe&config=eyJ1cmwiOiJodHRwczovL21jcC5zdHJpcGUuY29tIn0%3D) Select **Install in Cursor** to open Cursor and add the Stripe MCP server. To configure it manually, add the following configuration to `~/.cursor/mcp.json`. For more information, see [Cursor’s MCP documentation](https://docs.cursor.com/context/model-context-protocol). ```json { "mcpServers": { "stripe": { "url": "https://mcp.stripe.com" } } } ``` #### Claude Code Run the following command to add the Stripe MCP server to Claude Code: ```bash claude mcp add --transport http stripe https://mcp.stripe.com/ ``` After you add the server, authenticate Stripe with OAuth. ```bash claude /mcp ``` To authenticate with an [agent API key](https://docs.stripe.com/keys.md#agent-keys) instead of OAuth, add the server to your project’s `.mcp.json` file and reference an environment variable that holds your agent API key, rather than passing the key on the command line. In this example, `${AGENT_API_KEY}` is a placeholder; replace `AGENT_API_KEY` with the actual name of your environment variable, and set that environment variable in your shell before running Claude Code. ```json { "mcpServers": { "stripe": { "type": "http", "url": "https://mcp.stripe.com", "headers": { "Authorization": "Bearer ${AGENT_API_KEY}" } } } } ``` For more information, see [Claude Code MCP documentation](https://docs.anthropic.com/en/docs/claude-code/mcp#configure-mcp-servers). #### Claude Desktop You can [install the official Stripe connector in Claude](https://claude.ai/directory/de127013-63f1-43d0-8dd2-b6cb5b4e5d1b) on the web and in Claude Desktop. 1. Select **Connect to Claude** and add the connector to your account or workspace. 2. Sign in to your Stripe account and grant permissions to Claude using the OAuth window when prompted. 3. In a conversation, select the plus icon, select **Connectors** and enable Stripe. For Team and Enterprise accounts, an owner must add the connector to the workspace before members can connect their Stripe accounts. #### Codex Run the following command to add the Stripe MCP server to Codex: ```bash codex mcp add stripe --url https://mcp.stripe.com ``` The ChatGPT desktop app, Codex CLI and Codex IDE extension support MCP servers and share the same configuration on your computer. To learn more, see the OpenAI [Codex MCP documentation](https://learn.chatgpt.com/docs/extend/mcp). After you authenticate, you can switch between the ChatGPT desktop app, Codex CLI and Codex IDE extension without configuring the Stripe MCP server again. To authenticate with an [agent API key](https://docs.stripe.com/keys.md#agent-keys) instead of OAuth, set `bearer_token_env_var` to the name of an environment variable that holds your agent API key. In this example, `AGENT_API_KEY` is a placeholder; replace it with the actual name of your environment variable, not the name of the variable wrapped in braces. ```toml [mcp_servers.stripe] url = "https://mcp.stripe.com" bearer_token_env_var = "AGENT_API_KEY" # Replace with the name of your environment variable ``` #### ChatGPT You can [install the official Stripe plugin in ChatGPT](https://chatgpt.com/plugins/plugin_connector_690ab09fa43c8191bca40280e4563238). Connect your Stripe account and grant permissions to ChatGPT in the OAuth window when prompted. To learn more, see the OpenAI [Codex MCP documentation](https://learn.chatgpt.com/docs/extend/mcp). #### VS Code [Install in VS Code](https://vscode.dev/redirect/mcp/install?name=stripe&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.stripe.com%22%7D) Select **Install in VS Code** to open VS Code and add the Stripe MCP server. To configure it manually, add the following configuration to `.vscode/mcp.json` in your workspace. See the [VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) for more information. ```json { "servers": { "stripe": { "type": "http", "url": "https://mcp.stripe.com" } } } ``` #### Other MCP is an open protocol supported by many clients. Follow your client’s MCP setup instructions and use `https://mcp.stripe.com` as the server URL. Use OAuth when your client supports it. If your client doesn’t support OAuth, use an [agent API key](https://docs.stripe.com/keys.md#agent-keys) as a bearer token in the `Authorization` header. For example, if your client accepts a `headers` property, use the following configuration: ```json { "stripe": { "url": "https://mcp.stripe.com", "headers": { "Authorization": "Bearer {{AGENT_API_KEY}}" } } } ``` ## Manage MCP access and sessions Stripe’s MCP server supports two authentication methods: 1. **OAuth**: Use OAuth when a client accesses Stripe on behalf of your Stripe user account. 2. **API keys**: Use API keys when an AI application needs independent, persistent access to Stripe. When you connect an MCP client with OAuth, the client opens Stripe’s OAuth consent page. You can grant access to one or more live mode accounts or sandboxes and set different permissions for each environment. See the [MCP specification](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization#2-1-1-oauth-grant-types) for details. If your organisation manages your device or network, your IT administrator might block connections to external MCP servers. When the Stripe MCP server doesn’t connect in a managed environment, ask your IT department to allow `mcp.stripe.com`. ### Manage MCP access for all team members If you’re an administrator, you can [enable or disable MCP access](https://dashboard.stripe.com/settings/mcp-and-cli-access) for your entire team in the Dashboard. Configure access separately for live mode and sandbox environments. ### Manage your sessions Your authorised MCP clients appear under **OAuth sessions** in your [user settings](https://dashboard.stripe.com/settings/user). To revoke a session: 1. Find the client in the **OAuth sessions** list. 2. Click the overflow menu (⋯). 3. Select **Revoke access**. ### Manage sessions as an administrator To view or revoke another user’s sessions, your role must include permissions to manage team members. The **Administrator** role includes these permissions. 1. Open [Team and security](https://dashboard.stripe.com/settings/team) in the Dashboard. 2. Select the team member you want to manage. 3. Find the **OAuth sessions** table. 4. To revoke one session, click its overflow menu and select **Revoke access**. To revoke every listed session, select **Revoke all**. Session management applies only to the account or organisation and environment – live mode or a sandbox – that you’re currently viewing. Revoking a session removes access only within that scope. The session remains active for accounts outside your current scope. When you view an organisation, the **Accounts** column shows the accounts associated with each session. ## Authenticate Stripe MCP Use OAuth for interactive MCP clients. OAuth lets you authorise and revoke a client without sharing an API key. For autonomous clients that can’t use OAuth, create an [agent API key](https://docs.stripe.com/keys.md#agent-keys) with only the permissions the client needs. You can identify agent API keys in the Dashboard by the **Agent** badge. Pass the agent API key as the bearer token in the `Authorisation` header of your request. Test the new configuration in a sandbox, then expire the old key. > #### Update API key authentication by 31 October 2026 > > Beginning 31 October 2026, Stripe MCP no longer accepts full-access secret keys or restricted API keys without the Agent tag. Before then, replace these keys with newly created Agent Keys or reconnect with OAuth. Requests using an unsupported key receive a `401` response with an OAuth discovery challenge. ## Tools The server exposes the following [MCP tools](https://modelcontextprotocol.io/docs/concepts/tools). Enable human confirmation of tools and exercise caution when using the Stripe MCP with other servers to avoid prompt injection attacks. If you have feedback or want to see more tools, email us at [mcp@stripe.com](mailto:mcp@stripe.com). | Resource | Tool | Description | | --- | --- | --- | | **API tools** | `stripe_api_search` | Search for Stripe API methods by keyword | | `stripe_api_details` | Get detailed parameter information for a specific Stripe API method. | | `stripe_api_read` | Read data with any Stripe API `GET` method | | `stripe_api_write` | Write data with any Stripe API `POST`, `PATCH`, `PUT` and `DELETE` method | | **Account** | `get_stripe_account_info` | [Retrieve account](https://docs.stripe.com/api/accounts/retrieve.md) | | **[Analytics](https://docs.stripe.com/data/analyze-with-ai.md)** | `stripe_analytics` | - (Preview) Query metrics, analyse subscriptions and billing and run financial reports - (Requires Sigma) Build SQL queries based on natural language | | **Treasury** (Public preview) | `get_balance_summary` | Displays an interactive balance summary across the Stripe balance and Treasury accounts | | **Others** | `search_stripe_documentation` | Search the Stripe documentation for the given question and language | | `stripe_implementation_planner` | Guides the user through Stripe products to help users accept payments, sell products online, set up billing or build any Stripe integration | | `send_stripe_feedback` | Share feedback about Stripe’s products | The Stripe MCP server exposes multiple APIs that you can call with the `stripe_api_read` and `stripe_api_write` tools. This access makes much of the API available through MCP without increasing the context window unnecessarily. ### Supported API methods - [List all customers](https://docs.stripe.com/api/customers/list.md) - [Retrieve a customer](https://docs.stripe.com/api/customers/retrieve.md) - [Create a customer](https://docs.stripe.com/api/customers/create.md) - [Update a customer](https://docs.stripe.com/api/customers/update.md) - [List all charges](https://docs.stripe.com/api/charges/list.md) - [Retrieve a charge](https://docs.stripe.com/api/charges/retrieve.md) - [List all refunds for a charge](https://docs.stripe.com/api/refunds/list.md) - [List all refunds](https://docs.stripe.com/api/refunds/list.md) - [Retrieve a refund](https://docs.stripe.com/api/refunds/retrieve.md) - [Create refund](https://docs.stripe.com/api/refunds/create.md) - [List all PaymentIntents](https://docs.stripe.com/api/payment_intents/list.md) - [Retrieve a PaymentIntent](https://docs.stripe.com/api/payment_intents/retrieve.md) - [List PaymentMethods](https://docs.stripe.com/api/payment_methods/list.md) - [Retrieve a PaymentMethod](https://docs.stripe.com/api/payment_methods/retrieve.md) - [List a customer’s PaymentMethods](https://docs.stripe.com/api/payment_methods/list.md) - [Retrieve a customer’s PaymentMethod](https://docs.stripe.com/api/payment_methods/retrieve.md) - [List payment method configurations](https://docs.stripe.com/api/payment_method_configurations/list.md) - [Retrieve a payment method configuration](https://docs.stripe.com/api/payment_method_configurations/retrieve.md) - [List payment method domains](https://docs.stripe.com/api/payment_method_domains/list.md) - [Create a payment method domain](https://docs.stripe.com/api/payment_method_domains/create.md) - [List all SetupIntents](https://docs.stripe.com/api/setup_intents/list.md) - [Retrieve a SetupIntent](https://docs.stripe.com/api/setup_intents/retrieve.md) - [List all Checkout Sessions](https://docs.stripe.com/api/checkout/sessions/list.md) - [Retrieve a Checkout Session](https://docs.stripe.com/api/checkout/sessions/retrieve.md) - [Retrieve a Checkout Session’s line items](https://docs.stripe.com/api/checkout/sessions/line_items.md) - [Create a Checkout Session](https://docs.stripe.com/api/checkout/sessions/create.md) - [List all invoices](https://docs.stripe.com/api/invoices/list.md) - [Retrieve an invoice](https://docs.stripe.com/api/invoices/retrieve.md) - [Retrieve an invoice’s line items](https://docs.stripe.com/api/invoice-line-item/retrieve.md) - [Create an invoice](https://docs.stripe.com/api/invoices/create.md) - [Update an invoice](https://docs.stripe.com/api/invoices/update.md) - [Finalise an invoice](https://docs.stripe.com/api/invoices/finalize.md) - [Mark an invoice as uncollectible](https://docs.stripe.com/api/invoices/mark_uncollectible.md) - [Void an invoice](https://docs.stripe.com/api/invoices/void.md) - [List all invoice items](https://docs.stripe.com/api/invoiceitems/list.md) - [Retrieve an invoice item](https://docs.stripe.com/api/invoiceitems/retrieve.md) - [Create an invoice item](https://docs.stripe.com/api/invoiceitems/create.md) - [Update an invoice item](https://docs.stripe.com/api/invoiceitems/update.md) - [List all payments for an invoice](https://docs.stripe.com/api/invoice-payment/list.md) - [Create a preview invoice](https://docs.stripe.com/api/invoices/create_preview.md) - [List all credit notes](https://docs.stripe.com/api/credit_notes/list.md) - [List subscriptions](https://docs.stripe.com/api/subscriptions/list.md) - [Retrieve a subscription](https://docs.stripe.com/api/subscriptions/retrieve.md) - [Create a subscription](https://docs.stripe.com/api/subscriptions/create.md) - [Update a subscription](https://docs.stripe.com/api/subscriptions/update.md) - [Cancel a subscription](https://docs.stripe.com/api/subscriptions/cancel.md) - [List all schedules](https://docs.stripe.com/api/subscription_schedules/list.md) - [Retrieve a schedule](https://docs.stripe.com/api/subscription_schedules/retrieve.md) - [List all subscription items](https://docs.stripe.com/api/subscription_items/list.md) - [List all coupons](https://docs.stripe.com/api/coupons/list.md) - [Retrieve a coupon](https://docs.stripe.com/api/coupons/retrieve.md) - [Create a coupon](https://docs.stripe.com/api/coupons/create.md) - [Update a coupon](https://docs.stripe.com/api/coupons/update.md) - [Delete a coupon](https://docs.stripe.com/api/coupons/delete.md) - [List all promotion codes](https://docs.stripe.com/api/promotion_codes/list.md) - [Retrieve a promotion code](https://docs.stripe.com/api/promotion_codes/retrieve.md) - [Create a promotion code](https://docs.stripe.com/api/promotion_codes/create.md) - [List all products](https://docs.stripe.com/api/products/list.md) - [Retrieve a product](https://docs.stripe.com/api/products/retrieve.md) - [Create a product](https://docs.stripe.com/api/products/create.md) - [Update a product](https://docs.stripe.com/api/products/update.md) - [List all prices](https://docs.stripe.com/api/prices/list.md) - [Retrieve a price](https://docs.stripe.com/api/prices/retrieve.md) - [Create a price](https://docs.stripe.com/api/prices/create.md) - [Update a price](https://docs.stripe.com/api/prices/update.md) - [List all payment links](https://docs.stripe.com/api/payment_links/list.md) - [Retrieve payment link](https://docs.stripe.com/api/payment_links/retrieve.md) - [Retrieve a payment link’s line items](https://docs.stripe.com/api/payment_links/line_items.md) - [Create a payment link](https://docs.stripe.com/api/payment_links/create.md) - [Update a payment link](https://docs.stripe.com/api/payment_links/update.md) - [List all disputes](https://docs.stripe.com/api/disputes/list.md) - [Retrieve a dispute](https://docs.stripe.com/api/disputes/retrieve.md) - [Update a dispute](https://docs.stripe.com/api/disputes/update.md) - [List all webhook endpoints](https://docs.stripe.com/api/webhook_endpoints/list.md) - [Retrieve a webhook endpoint](https://docs.stripe.com/api/webhook_endpoints/retrieve.md) - [Create a webhook endpoint](https://docs.stripe.com/api/webhook_endpoints/create.md) - [List all event destinations](https://docs.stripe.com/api/v2/core/event-destinations/list.md) - [Retrieve an event destination](https://docs.stripe.com/api/v2/core/event-destinations/retrieve.md) - [Create an event destination](https://docs.stripe.com/api/v2/core/event-destinations/create.md) - [Update an event destination](https://docs.stripe.com/api/v2/core/event-destinations/update.md) - [List portal configurations](https://docs.stripe.com/api/customer_portal/configurations/list.md) - [Retrieve a portal configuration](https://docs.stripe.com/api/customer_portal/configurations/retrieve.md) - [Create a portal configuration](https://docs.stripe.com/api/customer_portal/configurations/create.md) - [Update a portal configuration](https://docs.stripe.com/api/customer_portal/configurations/update.md) - [Create a portal session](https://docs.stripe.com/api/customer_portal/sessions/create.md) - [List all application fees](https://docs.stripe.com/api/application_fees/list.md) - [List all transfers](https://docs.stripe.com/api/transfers/list.md) - [Retrieve a transfer](https://docs.stripe.com/api/transfers/retrieve.md) - [List customer balance transactions](https://docs.stripe.com/api/customer_balance_transactions/list.md) - [Retrieve a cash balance](https://docs.stripe.com/api/cash_balances/retrieve.md) - [List cash balance transactions](https://docs.stripe.com/api/customer_cash_balance_transactions/list.md) - [Create a test clock](https://docs.stripe.com/api/test_helpers/test_clocks/create.md) - [Retrieve balance](https://docs.stripe.com/api/balance/retrieve.md) - [Retrieve tax settings](https://docs.stripe.com/api/tax/settings/retrieve.md) - [Update tax settings](https://docs.stripe.com/api/tax/settings/update.md) - [List all tax codes](https://docs.stripe.com/api/tax_codes/list.md) - [Retrieve a tax code](https://docs.stripe.com/api/tax_codes/retrieve.md) - [List all tax registrations](https://docs.stripe.com/api/tax/registrations/list.md) - [Retrieve a tax registration](https://docs.stripe.com/api/tax/registrations/retrieve.md) - [Create a tax registration](https://docs.stripe.com/api/tax/registrations/create.md) - [Update a tax registration](https://docs.stripe.com/api/tax/registrations/update.md) - [Create a Metric Query Result](https://docs.stripe.com/api/v2/data/analytics/metric-query-results/create.md?api-version=2026-07-29.preview) (Private preview) - [Create a Query Run](https://docs.stripe.com/api/v2/data/reporting/query-runs/create.md?api-version=2026-07-29.preview) (Public preview) - [Create a tax calculation](https://docs.stripe.com/api/tax/calculations/create.md) - [Retrieve a tax calculation](https://docs.stripe.com/api/tax/calculations/retrieve.md) - [Retrieve a tax calculation’s line items](https://docs.stripe.com/api/tax/calculations/line_items.md) - [List all balance transactions](https://docs.stripe.com/api/balance_transactions/list.md) - [Retrieve a balance transaction](https://docs.stripe.com/api/balance_transactions/retrieve.md) - [List all payouts](https://docs.stripe.com/api/payouts/list.md) - [Retrieve a payout](https://docs.stripe.com/api/payouts/retrieve.md) - [List all authorisations](https://docs.stripe.com/api/issuing/authorizations/list.md) - [Retrieve an authorisation](https://docs.stripe.com/api/issuing/authorizations/retrieve.md) - [List all cardholders](https://docs.stripe.com/api/issuing/cardholders/list.md) - [Retrieve a cardholder](https://docs.stripe.com/api/issuing/cardholders/retrieve.md) - [List all cards](https://docs.stripe.com/api/issuing/cards/list.md) - [Retrieve a card](https://docs.stripe.com/api/issuing/cards/retrieve.md) - [List all disputes](https://docs.stripe.com/api/issuing/disputes/list.md) - [Retrieve a dispute](https://docs.stripe.com/api/issuing/disputes/retrieve.md) - [List all transactions](https://docs.stripe.com/api/issuing/transactions/list.md) - [Retrieve a transaction](https://docs.stripe.com/api/issuing/transactions/retrieve.md) - [List accounts](https://docs.stripe.com/api/v2/core/accounts/list.md) - [Retrieve an account](https://docs.stripe.com/api/v2/core/accounts/retrieve.md) - [List Adjustments](https://docs.stripe.com/api/v2/money-management/adjustments/list.md?api-version=2026-05-27.preview) - [Retrieve an Adjustment](https://docs.stripe.com/api/v2/money-management/adjustments/retrieve.md?api-version=2026-05-27.preview) - [List Financial Accounts](https://docs.stripe.com/api/v2/money-management/financial-accounts/list.md?api-version=2026-05-27.preview) - [Retrieve a Financial Account](https://docs.stripe.com/api/v2/money-management/financial-accounts/retrieve.md?api-version=2026-05-27.preview) - [List Financial Addresses](https://docs.stripe.com/api/v2/money-management/financial-addresses/list.md?api-version=2026-05-27.preview) - [Retrieve a Financial Address](https://docs.stripe.com/api/v2/money-management/financial-addresses/retrieve.md?api-version=2026-05-27.preview) - [List Inbound Transfers](https://docs.stripe.com/api/v2/money-management/inbound-transfers/list.md?api-version=2026-05-27.preview) - [Retrieve an Inbound Transfer](https://docs.stripe.com/api/v2/money-management/inbound-transfers/retrieve.md?api-version=2026-05-27.preview) - [Retrieve an Outbound Payment quote](https://docs.stripe.com/api/v2/money-management/outbound-payment-quotes/retrieve.md?api-version=2026-05-27.preview) - [List Outbound Payments](https://docs.stripe.com/api/v2/money-management/outbound-payments/list.md?api-version=2026-05-27.preview) - [Retrieve an Outbound Payment](https://docs.stripe.com/api/v2/money-management/outbound-payments/retrieve.md?api-version=2026-05-27.preview) - [List Outbound Setup Intents](https://docs.stripe.com/api/v2/money-management/outbound-setup-intents/list.md?api-version=2026-05-27.preview) - [Retrieve an Outbound Setup Intent](https://docs.stripe.com/api/v2/money-management/outbound-setup-intents/retrieve.md?api-version=2026-05-27.preview) - [List Outbound Transfers](https://docs.stripe.com/api/v2/money-management/outbound-transfers/list.md?api-version=2026-05-27.preview) - [Retrieve an Outbound Transfer](https://docs.stripe.com/api/v2/money-management/outbound-transfers/retrieve.md?api-version=2026-05-27.preview) - [List Payout Methods](https://docs.stripe.com/api/v2/money-management/payout-methods/list.md?api-version=2026-05-27.preview) - [Retrieve a Payout Method](https://docs.stripe.com/api/v2/money-management/payout-methods/retrieve.md?api-version=2026-05-27.preview) - [Retrieve Bank Account Specification](https://docs.stripe.com/api/v2/money-management/payout-methods-bank-account-specs/retrieve.md?api-version=2026-05-27.preview) - [List Received Credits](https://docs.stripe.com/api/v2/money-management/received-credits/list.md?api-version=2026-05-27.preview) - [Retrieve a Received Credit](https://docs.stripe.com/api/v2/money-management/received-credits/retrieve.md?api-version=2026-05-27.preview) - [List Received Debits](https://docs.stripe.com/api/v2/money-management/received-debits/list.md?api-version=2026-05-27.preview) - [Retrieve a Received Debit](https://docs.stripe.com/api/v2/money-management/received-debits/retrieve.md?api-version=2026-05-27.preview) - [List Transaction Entries](https://docs.stripe.com/api/v2/money-management/transaction-entries/list.md?api-version=2026-05-27.preview) - [Retrieve a Transaction Entry](https://docs.stripe.com/api/v2/money-management/transaction-entries/retrieve.md?api-version=2026-05-27.preview) - [List Transactions](https://docs.stripe.com/api/v2/money-management/transactions/list.md?api-version=2026-05-27.preview) - [Retrieve a Transaction](https://docs.stripe.com/api/v2/money-management/transactions/retrieve.md?api-version=2026-05-27.preview) ## Confirm actions by agents acting on your behalf When you connect an AI agent to Stripe through the MCP server using your user credentials, you authorise the agent to access data and take actions in Stripe on your behalf. To prevent agents from making mistakes, Stripe requires human confirmation before it takes certain `stripe_api_write` actions, such as refunds and outbound payments. To confirm an action, click the URL provided by your agent and review the details of the request. ![Confirm a refund request](https://b.stripecdn.com/docs-statics-srv/assets/human-confirmation.d768e677a3bf87585ee29a003df41b00.png) Confirm a refund request When you click **Approve**, Stripe provides the agent with an approval token, but you need to tell the agent to retry the operation, which doesn’t require human confirmation. If you don’t approve the action within 24 hours, it expires. ## Use MCP with connected accounts By default, Stripe MCP tools operate on the Stripe account associated with your OAuth session or API key. If you only need your agent to work with your platform account, use the standard setup above. If you’re a [Connect platform](https://docs.stripe.com/connect.md), you can also use MCP to retrieve or update resources for your connected accounts. For example, a support agent could retrieve a customer or investigate a payment for a specific connected account. MCP doesn’t support OAuth when acting on behalf of connected accounts. Instead, authenticate with a [restricted API key](https://docs.stripe.com/keys/restricted-api-keys.md#create-a-restricted-api-key) for your platform and grant only the connected-account permissions that your agent needs. To make an MCP call as a connected account, pass the `Stripe-Account` header. This is useful when you provide an agent that allows your connected accounts to make MCP calls through your platform. ```json { "mcpServers": { "stripe": { "url": "https://mcp.stripe.com", "headers": { "Authorization": "Bearer {{AGENT_API_KEY}}", "Stripe-Account": "acct_xxxxxxxxx" } } } } ``` ## See also - [Plugin for agents](https://docs.stripe.com/agents/plugin.md) - [Agent skills](https://docs.stripe.com/skills.md) - [View MCP tool call logs in Workbench](https://docs.stripe.com/workbench/overview.md#mcp-tool-call-logs)