Stripe MCP server
Answer billing questions with Arc0’s Stripe tools for customers, invoices, charges, and subscriptions. The two write tools create customers and update customer metadata; they do not move money. Connect through Arc0 to use the actions your identity is allowed to call.
Working with Stripe
A support question about billing starts with the correct customer. Use stripe.list_customers with an email filter, then stripe.get_customer to confirm the record. With that ID, stripe.list_invoices, stripe.list_payment_intents, and stripe.list_charges can supply the existing billing activity needed to explain a payment’s state.
For recurring billing, stripe.list_subscriptions returns subscription information and indicates when embedded items are incomplete. Do not add up a partial item list and present it as a complete subscription total. stripe.get_balance shows available and pending amounts by currency, while stripe.get_account helps confirm which Stripe account is connected.
The write path is limited to customer administration. stripe.create_customer adds a customer, and stripe.update_customer_metadata maintains application references on an existing one. Keep card and bank details out of metadata. After an uncertain creation, search for the customer before trying again. Refunds, payment collection, payouts, and subscription cancellation are outside this action set. Test and live keys connect to separate modes, so confirm the mode before writing.
Official MCP reference: Stripe documentation.
Agent workflows for Stripe.
Check a customer’s billing state
Use stripe.list_customers and stripe.get_customer to identify the account before reading related billing records.
Review unpaid invoices
Use stripe.list_invoices with customer and status filters to gather a bounded invoice list.
Inspect subscriptions and charges
Use stripe.list_subscriptions and stripe.list_charges to explain existing billing activity without changing it.
Maintain customer references
Use stripe.create_customer or stripe.update_customer_metadata to record a customer and approved application identifiers.
10 Stripe actions, graded by risk.
These actions come from the Arc0 registry. Your identity, provider permissions and Arc0 policies determine which actions can run.
read
8Look things up, subject to your permissions.
- stripe.list_customersList customers
List Stripe customers newest first, optionally only those with an exact email or created in a time range. Use when the user wants to find a customer or browse recent ones. Pass next_cursor as startingAfter for the next page.
- stripe.get_customerGet customer
Get one Stripe customer by id (cus_...): name, email, phone, credit balance, delinquency and metadata. Use when the user asks about a specific customer. A deleted customer comes back with deleted true.
- stripe.list_invoicesList invoices
List Stripe invoices newest first with status, totals and amount still due (minor units), filtered by customer, subscription, status or creation time. Use when the user asks what a customer was billed, owes or has paid. Pass next_cursor as startingAfter for more.
- stripe.list_subscriptionsList subscriptions
List Stripe subscriptions with status, price, quantity, current period and cancellation, filtered by customer, price or status (default excludes canceled; use all). Use when the user asks what plan a customer is on. items_complete false: some items are missing. Pass next_cursor as startingAfter.
- stripe.list_payment_intentsList payments
List Stripe PaymentIntents newest first with amount, received amount, status and the last failure code, optionally for one customer or time range. Use when the user asks whether a payment went through or why it failed. Pass next_cursor as startingAfter for more.
- stripe.list_chargesList charges
List Stripe charges newest first with amount, refunded amount, dispute flag, failure reason and receipt link, filtered by customer, PaymentIntent or time. Use when the user asks about a specific payment attempt, refund status or dispute. Pass next_cursor as startingAfter.
- stripe.get_balanceGet balance
Show the Stripe balance per currency: funds available for payout and funds still pending, in minor units (cents). Use when the user asks how much money is in Stripe or what will be paid out next.
- stripe.get_accountGet account
Show the connected Stripe account: id, business and display name, country, default currency, and whether charges and payouts are enabled. Use when the user asks which Stripe account is connected or whether it can take payments.
write
2Create and change things. Allow, or ask the user first.
- stripe.create_customerCreate customer
Create a Stripe customer with name, email, phone, description and metadata. No payment method or charge. Use when the user asks to add a customer. After an unknown outcome, check list_customers by email before creating again.
- stripe.update_customer_metadataUpdate customer metadata
Set or clear metadata keys on a Stripe customer (null clears a key; other keys stay). Use when the user wants to tag or annotate a customer, e.g. a CRM id or account owner. Changes nothing else on the customer.
destructive
0Delete, cancel or archive. Ask first, or deny outright.
- No destructive actions.
Control access to Stripe.
Connect the intended Stripe account, authorize your AI client and set policies for its tools.
Provider permissions and Arc0 policy both apply. Allow reads, require approval for selected writes, or deny destructive actions. The audit log records execution decisions.
Configure policies and approvalsExample policy choices
- Read actions: allow where authorized
- stripe.create_customer: require approval
Arc0 MCP endpoint: https://api.arc0.ai/mcp
How Stripe connects.
Connect Stripe using API key. OAuth grants the provider scopes shown during consent; API keys and other credentials retain the permissions configured at the provider. Arc0 stores credentials in its encrypted vault and does not pass them to the model. Disconnect to remove access through Arc0; revoke a key at the provider to invalidate it there. Token refresh and provider-side revocation depend on the authentication lane and provider.
The connection serves authorized calls through Arc0 MCP and REST. How Arc0 handles credentials →
- AUTH
- API key
- CREDENTIALS
- Per-tenant encrypted vault
- MODEL SEES
- Results only, never credentials
- AUDIT LOG
- Every call, on every plan
Use Stripe with your AI client.
Sign in to Arc0 and connect Stripe in My apps. Then authorize your AI client separately. It only receives tools and accounts allowed for that identity.
Stripe with Claude
Claude Desktop + Claude Code
- In Claude Desktop, add Arc0 through the remote MCP settings and use OAuth. Follow the generic remote-client steps if your account’s interface differs.
- For Claude Code, run the command below. Open /mcp, select Arc0, and authenticate in your browser. Select your workspace and review access.
- Check the connection with claude mcp get arc0.
claude mcp add --transport http --scope user arc0 https://api.arc0.ai/mcpFull MCP setup and troubleshootingStripe with ChatGPT
ChatGPT on the web
- Open Plugins in ChatGPT, select the plus button, then Add custom MCP server.
- Name it Arc0, enter the server URL below, and choose OAuth. Use dynamic client registration if asked; no Arc0 API key is needed.
- Review the notice and select Create as a plugin. Complete Arc0 sign-in, workspace selection and consent, then install and select the plugin in your conversation. Labels and access vary by account; managed workspaces may require administrator approval.
https://api.arc0.ai/mcpFull MCP setup and troubleshootingStripe with OpenAI Codex
Codex app + CLI
- Run the registration command below. The app and CLI share ~/.codex/config.toml.
- Complete browser OAuth, choose your Arc0 workspace, and review access. If authentication does not start, run codex mcp login arc0.
- Check codex mcp list, then open a new Codex chat. Inspect an existing arc0 entry before changing it.
codex mcp add arc0 --url https://api.arc0.ai/mcpFull MCP setup and troubleshootingStripe with Cursor
Remote MCP setup
- Add Arc0 in your client’s remote MCP settings using the server URL below.
- Choose OAuth, sign in to Arc0, select the intended workspace and review access.
- Confirm the server is connected and start with an allowed read. These are generic remote-MCP steps; consult your client’s settings for its current interface.
https://api.arc0.ai/mcpFull MCP setup and troubleshootingStripe with VS Code
Remote MCP setup
- Add a remote HTTP MCP server named Arc0 using the URL below.
- Use OAuth and finish Arc0 sign-in, workspace selection and consent.
- Confirm discovery succeeds before requesting a read. These are generic remote-MCP steps; client UI and availability may differ.
https://api.arc0.ai/mcpFull MCP setup and troubleshootingStripe with Any MCP client
Streamable HTTP
- Use a client that supports remote MCP over Streamable HTTP. Add the server URL below and choose OAuth.
- For a client without OAuth, use a self-bound API key with execute permission in the X-API-Key header. Store it in secret storage or an environment variable, outside source control. Never send both an API key and an OAuth bearer token.
- Use the MCP clients guide for the SDK transport example and Embedded identity for business-managed end users.
https://api.arc0.ai/mcpFull MCP setup and troubleshootingAfter setup, ask your agent to find an allowed read action, load its schema, and execute it on the intended account. Check Activity for the receipt. A connected MCP client alone does not confirm a successful provider call.
More finance and accounting apps.
Stripe and Arc0, answered.
Is there an official Stripe MCP server, and how does Arc0 differ?
Yes. Stripe provides an official MCP server. Arc0’s Stripe tools use a curated REST action set focused on billing reads and customer administration, with no money-moving operations.
Which permissions does Arc0 need for Stripe?
Use a test or live secret key or restricted API key; publishable keys are not supported. Prefer restricted permissions: Customers write for both writes, plus read access to invoices, payment intents, charges, subscriptions, balance, and account identity. The exact restricted-key permission needed for account identity remains a live-acceptance check.
Does this work with Claude, ChatGPT, Codex and Cursor?
Yes, through Arc0 MCP when your Claude, ChatGPT, Codex, or Cursor client supports remote MCP and your account permits it. Connect the app in Arc0 and configure your client using the Arc0 setup guide. App permissions still apply.
How are credentials stored, refreshed and revoked?
Arc0 stores the key encrypted; there is no OAuth refresh in this version. Disconnect stops Arc0 access but does not expire the Stripe key. Expire or rotate it in Stripe to invalidate it elsewhere, accounting for any overlap window.
What happens with rate limits or errors?
Stripe has endpoint, concurrency, and account limits. Arc0 reports throttling, restricted-key permission failures, and invalid inputs. An uncertain customer creation must be reconciled before another attempt; a new execution can create a duplicate.
What is the availability of these Stripe tools?
These tools are available. Connect the app in Arc0 and authorize your AI client. The action list describes the current implementation.
Plug Stripe into your agent.
Stripe MCP server: 10 actions including list customers, get customer, list invoices. Connect through Arc0.
Free to build · MCP + REST · Audit log on every plan
Stripe and its logo are trademarks of their respective owners. Arc0 is not affiliated with or endorsed by Stripe.