MewCP Stripe MCP

Accept payments, manage subscriptions, and automate billing workflows all through natural language.

A Model Context Protocol (MCP) server that exposes Stripe's API for payment processing, customer management, subscriptions, and financial operations.

The Stripe MCP Server provides a complete interface to Stripe's payment infrastructure:

- Full customer lifecycle management — create, search, update, and delete customers
- Payment processing via charges and payment intents
- Product & pricing catalog management
- Subscription billing with trial support
- Real-time account balance visibility

- Automating billing workflows and subscription management without writing code
- Looking up customer payment history and account status through AI assistants
- Setting up products and pricing plans for new features or services

Creates a customer record in Stripe that can hold payment methods, subscriptions, and invoices.

- api_key (string, required) — Stripe API key (starts with sk_) - email (string, optional) — Customer's email address - name (string, optional) — Customer's full name - description (string, optional) — Internal description for the customer - metadata (string, optional) — JSON string of metadata key-value pairs (e.g. '{"plan": "enterprise"}')

{ "success": true, "customer_id": "cus_xxx", "email": "user@example.com", "name": "Jane Doe", "description": "Enterprise customer", "created": 1716720000, "metadata": {} }

Returns full customer details including balance, delinquency status, and metadata.

- api_key (string, required) — Stripe API key - customer_id (string, required) — Customer ID (e.g. cus_xxx)

{ "success": true, "customer_id": "cus_xxx", "email": "user@example.com", "name": "Jane Doe", "balance": 0, "delinquent": false, "created": 1716720000, "metadata": {} }

Returns up to 100 customers per page with cursor-based pagination.

- api_key (string, required) — Stripe API key - limit (integer, optional) — Number of customers to return, 1–100 (default: 10) - starting_after (string, optional) — Customer ID to paginate from

{ "success": true, "has_more": true, "count": 10, "customers": [{ "id": "cus_xxx", "email": "...", "name": "...", "created": 1716720000 }] }

Uses Stripe's search query language to find customers matching specific criteria.

- api_key (string, required) — Stripe API key - query (string, required) — Search query (e.g. 'email:"user@example.com"' or 'name:"Jane"') - limit (integer, optional) — Number of results, 1–100 (default: 10)

{ "success": true, "has_more": false, "count": 1, "customers": [{ "id": "cus_xxx", "email": "user@example.com", "name": "Jane Doe" }] }

Creates a direct charge on a customer. Amount is in the smallest currency unit (cents for USD).

- api_key (string, required) — Stripe API key - amount (integer, required) — Amount in cents (e.g. 1000 = $10.00) - currency (string, optional) — Currency code: usd, eur, gbp, etc. (default: usd) - customer_id (string, optional) — Customer ID to charge - description (string, optional) — Description of the charge - metadata (string, optional) — JSON string of metadata

{ "success": true, "charge_id": "ch_xxx", "amount": 1000, "currency": "usd", "status": "succeeded", "paid": true }

Creates a payment intent and returns aclient_secretfor frontend confirmation via Stripe.js.

- api_key (string, required) — Stripe API key - amount (integer, required) — Amount in cents - currency (string, optional) — Currency code (default: usd) - customer_id (string, optional) — Customer ID - description (string, optional) — Description - metadata (string, optional) — JSON string of metadata - confirm (boolean, optional) — Confirm immediately (default: false)

{ "success": true, "payment_intent_id": "pi_xxx", "client_secret": "pi_xxx_secret_xxx", "amount": 2000, "currency": "usd", "status": "requires_payment_method" }

Creates a product in your Stripe catalog. Products require a price before they can be sold.

- api_key (string, required) — Stripe API key - name (string, required) — Product name - description (string, optional) — Product description - metadata (string, optional) — JSON string of metadata

{ "success": true, "product_id": "prod_xxx", "name": "Pro Plan", "description": "Access to all pro features", "active": true }

Defines the billing amount and interval for a product. Supports one-time and recurring (subscription) pricing.

- api_key (string, required) — Stripe API key - product_id (string, required) — Product ID to attach the price to - unit_amount (integer, required) — Amount in cents - currency (string, optional) — Currency code (default: usd) - recurring_interval (string, optional) — 'month' or 'year' for subscription pricing

{ "success": true, "price_id": "price_xxx", "product": "prod_xxx", "unit_amount": 999, "currency": "usd", "recurring": { "interval": "month" } }

Creates a recurring subscription for a customer using a price ID. Supports trial periods.

- api_key (string, required) — Stripe API key - customer_id (string, required) — Customer ID - price_id (string, required) — Price ID for the subscription plan - trial_period_days (integer, optional) — Number of free trial days - metadata (string, optional) — JSON string of metadata

{ "success": true, "subscription_id": "sub_xxx", "customer": "cus_xxx", "status": "active", "current_period_start": 1716720000, "current_period_end": 1719312000 }

Cancels a subscription either at the end of the current billing period or immediately.

- api_key (string, required) — Stripe API key - subscription_id (string, required) — Subscription ID to cancel - cancel_at_period_end (boolean, optional) — true = cancel at period end, false = cancel immediately (default: true)

{ "success": true, "subscription_id": "sub_xxx", "status": "active", "cancel_at_period_end": true }

Returns available and pending balances across all currencies for the Stripe account.

- api_key (string, required) — Stripe API key

{ "success": true, "available": [{ "amount": 50000, "currency": "usd" }], "pending": [{ "amount": 12000, "currency": "usd" }], "livemode": true }

- Go toStripe Dashboard
- ClickDevelopersin the top navigation
- SelectAPI keysfrom the left sidebar
- Copy yourSecret key(starts withsk_live_for production orsk_test_for testing)

- Cause:Upstream Stripe API returned an error
- Solution:
- Check Stripe service status atStripe Status Page
- Verify your API key has the required permissions (live vs. test mode)
- Review the error message for specific details — Stripe errors are descriptive

- Stripe API Documentation— Official API reference
- Stripe API Reference— Complete endpoint reference
- FastMCP Docs— FastMCP specification
- FastMCP Credentials— FastMCP Credentials package for credential handling

Trust and reputation layer for AI agents that handle money. Agent Credit Score (300-850), hash-chained ledger, behavioral finance, real payment rails (Stripe, Paystack, Lightning), autonomous shopping with escrow.