Stripe MCP connector

What agents can do

The server has 41 actions (41 read, 0 write). The ones covered by the app's Stripe permissions are:

• Balance and payouts: get_balance, get_payouts and get_payout.
• Customers: get_customers and get_customer.
• Payments: get_charges, get_charge, get_refunds, get_refund, get_payment_intents and get_payment_intent.
• Billing: get_invoices, get_invoice, get_subscriptions and get_subscription.
• Catalog: get_products, get_product, get_prices and get_plans.
• Disputes: get_disputes and get_dispute.

Lists return page by page, with filters such as creation date, customer and status. See the full action list.

Before you connect

• A Stripe account you can authorize apps on.
• An InsightfulPipe workspace with a brand for the account. Owners, admins and operators can add connections.
• There are no API keys to copy. The InsightfulPipe app asks Stripe for 10 read permissions: customers, payment intents, charges and refunds, invoices, subscriptions, balance, products, plans, payouts and disputes.

Connect Stripe

1. In the InsightfulPipe app, open Connectors, choose Stripe and click Connect.
2. Click Connect to Stripe.
3. On Stripe's authorization page, review the read permissions and approve them.
4. Back in InsightfulPipe, check the connected account ID and whether it shows Live or Test mode.

Add the MCP server to your AI client

Server URL: https://stripe.insightfulmcp.com/ and server name: stripe-mcp.

• Claude: open Claude Connectors Settings, scroll to the bottom and click Add custom connector, paste the URL, click Add, then click Connect.
• ChatGPT: in ChatGPT Security Settings turn on Developer mode, click Create on the Connectors page, paste the URL, click Create, then click Connect. Turn the connector on in each new chat with + → More.
• Claude Code: run claude mcp add --transport http stripe-mcp https://stripe.insightfulmcp.com/, then type /mcp, select stripe-mcp and click Authenticate.
• Cursor: in the app, open MCP Servers, choose Stripe and click Install Stripe MCP, click Open Cursor then Install, then click Connect and Open.
• Gemini CLI: run gemini mcp add --transport http stripe-mcp https://stripe.insightfulmcp.com/, then /mcp auth stripe-mcp.
• Codex CLI: run codex mcp add stripe-mcp --url https://stripe.insightfulmcp.com/; authorization starts automatically.

Each client opens a browser window where you log in to InsightfulPipe and click Authorize access. Step-by-step guides: Claude, ChatGPT, Claude Code, Cursor, Gemini CLI and Codex CLI. To reach every connected platform through one server, use the unified server.

Permissions and safety

• The connector is read-only by design. There are no write or destructive actions, and no Read Only or Read + Write choice to make.
• Owners, admins and operators can still turn individual read actions off per account in Configure actions for this account.
• Members with the User role only reach Stripe accounts granted to them, with the read actions enabled on those accounts.
• You can remove the connection in InsightfulPipe or uninstall the app in Stripe at any time.

Limits

• Reads are limited to the objects the InsightfulPipe Stripe app has permission to read. Other catalog actions, such as coupons, promotion codes, checkout sessions, events, transfers or files, need permissions the app doesn't request and can return a permission error.
• The connector doesn't read data on behalf of Stripe Connect connected accounts.
• Large lists are returned page by page.
• Stripe API rate limits apply, and the server retries when Stripe asks it to slow down.
• Access tokens are refreshed automatically.

Example prompts

• "Using Stripe, what was our total charged amount and refunds last month?"
• "How many subscriptions are past due right now?"
• "Which invoices are still open and older than 30 days?"
• "List open disputes and their evidence due dates."

Troubleshooting

• A request returns a permission error: the object is outside the read permissions the InsightfulPipe app has in Stripe. Ask for data from the covered objects listed above.
• The connection shows Expired or Reconnect required: reconnect Stripe from Connectors and approve the InsightfulPipe app again.
• "You do not have access to this account. Contact your workspace admin to grant access.": an owner or administrator can grant you the Stripe account on your Manage Account Access page.

FAQ

Can an agent issue refunds or cancel subscriptions?

No. Every Stripe action on this server is a read. It can't create charges, refund payments, cancel subscriptions or update customers.

Do I need to create a Stripe API key?

No. You authorize the InsightfulPipe app through Stripe's authorization page, and InsightfulPipe stores and refreshes the resulting tokens.

Can I connect several Stripe accounts?

Yes. Each connection is one Stripe account, and each counts as one connection on your plan.

Related

• Stripe MCP server
• Connectors overview
• Shopify connector
• Roles and permissions
• MCP troubleshooting