Payment

Stripe MCP Server

Connect your account, then chat with AI to run tools.

Complete Stripe payment processing toolkit — 68 tools for payments, customers, subscriptions, invoices, checkout, products, financial operations, and reporting. Includes Customer 360, bulk metadata updates, customer timeline, and search across customers, products, subscriptions, and invoices.

68 tools
Agent guide included
Start Chatting

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for Stripe — workflow patterns, data models, and gotchas for your AI agent.

Stripe

Stripe uses Payment Intents for modern card payments (replace Charges for new integrations). Customers hold payment methods; Subscriptions link customers to recurring Prices. All IDs are strings (pi_, cus_, sub_, in_, cs_, etc.). Test mode uses sk_test_; live uses sk_live_.

Data Model

  • PaymentIntent (pi_) — primary payment flow. Create → confirm on client or server.
  • Charge (ch_) — legacy one-time payment. Prefer PaymentIntent for new code.
  • Customer (cus_) — stores payment methods and metadata. Search by name/email with fuzzy matching.
  • PaymentMethod (pm_) — card/bank. Attach to customer for reuse.
  • Subscription (sub_) — recurring billing. Links customer + Price. Searchable by metadata.
  • Invoice (in_) — billing document. Lifecycle: draft → add items → finalize → send/pay.
  • Checkout Session (cs_) — hosted payment page for one-time, subscription, or setup.
  • Payment Link (plink_) — reusable shareable payment URL. No code needed.
  • Product (prod_) and Price (price_) — catalog primitives. Prices are immutable. Products are searchable.
  • Refund (re_) — reverses a charge. Full or partial.
  • Balance and Payout (po_) — moving funds to bank.
  • Dispute (dp_) — chargeback. Submit evidence before deadline.
  • Events (ev_) — webhook-style audit log.

CRM-Like Capabilities

  • Customer 360: Get a full customer profile (details + charges + subscriptions + invoices + payment methods + computed summary) in one call. Shows total lifetime spend, MRR, and outstanding balance.
  • Bulk Metadata Update: Tag or enrich multiple customers at once — search by query, preview matches, then apply metadata. Use for lifecycle stage, company, industry, lead source, owner.
  • Customer Timeline: Chronological activity log for a customer — all payments, subscription changes, invoice events, payment method updates. Filter by event type or date range.

Search API

Customers, invoices, subscriptions, products support full-text search with query syntax: exact ':', fuzzy '~', range '>' '<', combined with AND/OR.

Gotchas

  • PaymentIntent vs Charge: Use PaymentIntent for new integrations.
  • Price is immutable: Create new Price, update Subscription to new price.
  • Amounts in cents: 2000 = $20.00 USD.
  • Invoice lifecycle: Draft → add items → finalize → send. Cannot revert finalized to draft.

Tools in this Server (68)

Stripe Attach Payment Method

Attach a payment method to a customer for future payments. After attaching, set it as the customer's default with stripe_upsert_customer(id='cus_...',...

Stripe Bulk Update Metadata

Update metadata on multiple customers at once. Search for customers by query, then apply metadata to all matches. Defaults to dry_run=true so you can ...

Stripe Cancel Payment Intent

Cancel a payment intent before it's confirmed or processed. Once canceled, it cannot be reused.

Stripe Cancel Payout

Cancel a pending payout. Can only cancel payouts that haven't been paid yet.

Stripe Cancel Subscription

Cancel a subscription immediately or at the end of the current billing period. Returns updated subscription object.

Stripe Confirm Payment Intent

Confirm a payment intent to process the payment. After confirmation, the payment is charged. The payment intent must have a payment_method attached (e...

Stripe Create Charge

Create a charge using the legacy Charges API. Prefer stripe_upsert_payment_intent for new integrations.

Stripe Create Checkout Session

Create a Stripe Checkout session — a hosted payment page. Returns a URL where the customer completes payment. Use mode='payment' for one-time charges,...

Stripe Create Invoice

Create a draft invoice for a customer. The invoice starts in 'draft' status. Add line items by creating invoice items (via stripe_create_invoice_item)...

Stripe Create Invoice Item

Add a line item to a draft invoice. Provide either amount+currency or a price ID. If no invoice ID is given, the item is added to the customer's next ...

Stripe Create Payment Link

Create a reusable payment link — a shareable URL for collecting payments. No code or website needed. Share via email, social media, or messaging. Unli...

Stripe Create Payment Method

Create a payment method (card, bank account, etc.). After creating, attach it to a customer with stripe_attach_payment_method, then optionally set it ...

Stripe Create Payout

Create a payout to transfer funds to your bank account. Payouts are processed according to your payout schedule.

Stripe Create Price

Create a price for a product. The product must already exist (use stripe_upsert_product first). Prices are immutable — to change pricing, create a new...

Stripe Create Refund

Create a refund for a charge or payment intent. Provide either charge or payment_intent ID (not both). The charge/payment must have status 'succeeded'...

Stripe Create Usage Record

Record usage for a metered subscription item. Used to calculate billing for usage-based subscriptions.

Stripe Customer 360

Get a complete 360-degree view of a customer in one call. Returns the customer profile plus their recent charges, active subscriptions, recent invoice...

Stripe Customer Timeline

Get a chronological timeline of all activity for a customer — charges, refunds, invoices, subscription changes, and payment intents. Aggregates data f...

Stripe Delete Customer

Permanently delete a customer. CAUTION: This action cannot be undone. All subscriptions will be canceled, payment methods removed, and the customer de...

Stripe Delete Product

Delete a product. Cannot delete products with active prices or used in active subscriptions.

Stripe Detach Payment Method

Detach a payment method from its customer. The payment method itself is not deleted but can no longer be used for that customer.

Stripe Fetch Balance

Get current Stripe account balance including available balance, pending balance, and currency breakdown.

Stripe Fetch Balance Transaction

Get detailed information about a specific balance transaction including amount, type, fee, and net amount.

Stripe Fetch Charge

Get detailed information about a specific charge including amount, status, payment method, and customer.

Stripe Fetch Checkout Session

Get detailed information about a checkout session including status, customer, payment details, and line items.

Stripe Fetch Customer

Get detailed information about a specific customer including contact info, payment methods, subscriptions, and balance.

Stripe Fetch Dispute

Get detailed information about a specific dispute including status, amount, reason, and evidence submission deadline.

Stripe Fetch Invoice

Get detailed information about a specific invoice including line items, amounts, status, customer, and payment details.

Stripe Fetch Payment Intent

Get detailed information about a specific payment intent including status, amount, payment method, and customer.

Stripe Fetch Payment Method

Get detailed information about a payment method including type, card details (masked), and customer association.

Stripe Fetch Payout

Get detailed information about a specific payout including amount, status, arrival date, and failure reason if applicable.

Stripe Fetch Price

Get detailed information about a specific price including amount, currency, and product association.

Stripe Fetch Product

Get detailed information about a specific product including name, description, and pricing.

Stripe Fetch Refund

Get detailed information about a specific refund including amount, status, reason, and associated charge.

Stripe Fetch Subscription

Get detailed information about a specific subscription including status, items, billing cycle, and customer.

Stripe Finalize Invoice

Finalize a draft invoice, changing its status to 'open'. Once finalized, the invoice is assigned a number and can be sent to the customer or paid. Thi...

Stripe List Balance Transactions

List balance transactions (charges, refunds, payouts, etc.) showing funds moving in and out of your Stripe account.

Stripe List Charges

List charges with optional filtering by customer, payment intent, transfer group, and date range. Returns paginated results.

Stripe List Checkout Sessions

List checkout sessions with optional filtering by customer, payment intent, subscription, status, and date range.

Stripe List Customers

List customers with optional filtering by email and date range. Returns paginated results with cursor for next page.

Stripe List Disputes

List disputes. Returns paginated results. Use this to monitor chargebacks and disputes.

Stripe List Events

List account events (payments, refunds, customer changes, etc.) for monitoring and triggering logic. Events are retained for 30 days.

Stripe List File Links

List file links for files stored on Stripe. Returns URL, expiration status, and metadata for each link.

Stripe List Files

List files uploaded to Stripe (reports, dispute evidence, identity documents). Returns name, size, purpose, and creation time.

Stripe List Invoices

List invoices with optional filtering by customer, subscription, status, collection method, and date range. Returns paginated results.

Stripe List Payment Intents

List payment intents with optional filtering by customer, status, and date range. Returns paginated results.

Stripe List Payment Links

List payment links with optional filtering by active status. Returns paginated results with the shareable URL for each link.

Stripe List Payment Methods

List payment methods for a customer. Optionally filter by type.

Stripe List Payouts

List payouts with optional filtering by status, creation date, and arrival date. Returns paginated results.

Stripe List Prices

List prices with optional filtering by product, active status, type (one_time/recurring), currency, and date. Prices are immutable.

Stripe List Products

List products with optional filtering by active status and creation date. Returns paginated results. Use stripe_search_products for fuzzy name search.

Stripe List Refunds

List refunds with optional filtering by charge, payment intent, and creation date. Returns paginated results.

Stripe List Setup Attempts

List setup attempts for a payment method setup intent. Useful for reviewing and troubleshooting payment method creation.

Stripe List Shipping Rates

List available shipping rates configured in your Stripe account. Returns rate details including amount, currency, and delivery estimates.

Stripe List Subscriptions

List subscriptions with optional filtering by customer and status. Returns paginated results.

Stripe List Usage Records

List usage record summaries for a metered subscription item. Shows consumption data for billing.

Stripe Pay Invoice

Pay an open invoice. By default, charges the customer's default payment method. Use paid_out_of_band=true for payments collected outside Stripe (cash,...

Stripe Search Customers

Search customers using Stripe's full-text search. More powerful than list — supports fuzzy name matching, metadata queries, date ranges, and combinati...

Stripe Search Invoices

Search invoices using Stripe's full-text search. More powerful than list — supports searching by customer, status, amount ranges, date ranges, and com...

Stripe Search Products

Search products using Stripe's full-text search. Supports fuzzy name matching, description search, metadata queries, and combinations with AND/OR. Mor...

Stripe Search Subscriptions

Search subscriptions using Stripe's full-text search. Supports metadata queries, date ranges, status filtering, and combinations with AND/OR. Use for ...

Stripe Send Invoice

Send a finalized invoice to the customer via email. The invoice must be in 'open' status. If it's still in 'draft', finalize it first with stripe_fina...

Stripe Submit Dispute Evidence

Submit evidence for a dispute. Evidence can include receipts, customer communication, shipping information, and more.

Stripe Upsert Customer

Create a new customer or update an existing customer. For create: provide email (recommended) and other fields. For update: provide customer ID and on...

Stripe Upsert Payment Intent

Create a new payment intent or update an existing one. For create: provide amount (required) and currency. Optionally attach a customer and payment_me...

Stripe Upsert Product

Create a new product or update an existing product. Products represent goods or services you sell. For create: provide name (required). After creating...

Stripe Upsert Subscription

Create a new subscription or update an existing one. For create: provide customer and items (price IDs from stripe_list_prices). Prerequisites: (1) cu...

Stripe Void Invoice

Void an open invoice. Voiding cancels the invoice permanently — no payment will be collected. Cannot void paid invoices (use refund instead).

Frequently Asked Questions

What is the Stripe MCP server?

Complete Stripe payment processing toolkit — 68 tools for payments, customers, subscriptions, invoices, checkout, products, financial operations, and reporting. Includes Customer 360, bulk metadata updates, customer timeline, and search across customers, products, subscriptions, and invoices. It provides 68 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect Stripe to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/stripe. Authentication is handled automatically.

How many tools does Stripe provide?

Stripe provides 68 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Stripe require?

Stripe uses API Key. Stripe requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Stripe to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/stripe

What is MCP?

Model Context Protocol lets AI tools call external capabilities securely through a single URL. This bundle groups tools behind an MCP endpoint that many clients can use.

Use this bundle in 3 steps

  1. Copy the MCP URL above
  2. Open your AI tool and add a new MCP/connector
  3. Paste the URL and follow any auth prompts

Claude Desktop Users

Skip the manual setup! Use the .mcpb file format for one-click installation. Check the Claude Desktop tab for setup instructions.

Pick your tool tab for exact steps

Select ChatGPT, Cursor, Claude Code, or another tab for copy-paste config.

Ready to use Stripe?

Sign in to connect your credentials and start running tools from the chat.

Stripe MCP Server & Skill — 68 Tools