Stripe

v1.0.00 callsAPI KeyGitHub

Documentation

Guide

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.

Overview

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

Perfect for:

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

Tools

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

Inputs:

- `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"}')

output:

{
  "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.

Inputs:

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

output:

{
  "success": true,
  "customer_id": "cus_xxx",
  "email": "user@example.com",
  "name": "Jane Doe",

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

Inputs:

- `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

output:

{
  "success": true,
  "has_more": true,

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

Inputs:

- `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)

output:

{
  "success": true,

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

Inputs:

- `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

output:

{
  "success"

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

Inputs:

- `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)

output:

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

Inputs:

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

output:

{
  "success": true,
  "product_id": "prod_xxx",
  "name": "Pro Plan",

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

Inputs:

- `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

output:

{
  "success": true,
  "price_id": "price_xxx"

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

Inputs:

- `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

output:

{
  "success": true,
  "subscription_id": "sub_xxx",

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

Inputs:

- `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)

output:

{
  "success": true,
  "subscription_id": "sub_xxx"

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

Inputs:

- `api_key` (string, required) — Stripe API key

output:

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

Getting Your Stripe API Key

Troubleshooting

Help Improve This Server

Missing a tool?

Found a bug?

Have an idea for an improvement?

Share your feedback directly with the maintainers - every feedback helps make this server better for everyone.

Open GitHub Issues →