Overview

The Stripe MCP Server is the official Model Context Protocol integration from Stripe, providing AI assistants with secure access to payment processing, subscription management, and financial infrastructure. With over 50 tools covering the Stripe API, it supports everything from looking up transactions to managing complex billing workflows.

Official Server:

Developed and maintained by Stripe. Remote MCP available at https://mcp.stripe.com with OAuth authentication. Part of the Stripe AI toolkit.

Key Features

💳

Payment Processing

Create payment intents, manage payment methods, and process refunds securely

🔄

Subscription Management

Create plans, manage recurring billing, upgrades, downgrades, and cancellations

👥

Customer Management

Retrieve customer profiles, payment history, saved cards, and billing details

📄

Invoicing

Create, send, and manage invoices with automatic payment tracking

🔐

OAuth Authentication

Remote MCP server with OAuth — no secret keys in configuration files

🛡️

Restricted API Keys

Granular permissions via Restricted Keys — only expose the tools your agent needs

Available Tools

Quick Reference

Tool	Purpose	Category
`create_payment_intent`	Create a new payment intent	Payments
`list_payment_intents`	List and filter payment intents	Payments
`create_refund`	Refund a completed payment	Payments
`retrieve_customer`	Get customer details and payment methods	Customers
`list_customers`	Search and list customers	Customers
`create_subscription`	Start a new subscription	Subscriptions
`cancel_subscription`	Cancel an active subscription	Subscriptions
`create_invoice`	Generate a new invoice	Invoicing
`retrieve_balance`	Get account balance and pending payouts	Finance
`list_products`	List available products and prices	Products

See the full list at docs.stripe.com/mcp#tools.

Detailed Usage

list_payment_intents▶

Retrieve a list of payment intents with filtering by status, date range, and customer.

{
  "limit": 10,
  "status": "succeeded",
  "created": { "gte": 1715904000 }
}

list_customers▶

Search customers by email, name, or metadata. Returns full customer profiles.

{
  "email": "[email protected]",
  "limit": 1
}

create_subscription▶

Create a new subscription for a customer with a given price ID.

{
  "customer": "cus_abc123",
  "items": [{ "price": "price_pro_monthly" }],
  "trial_period_days": 14
}

retrieve_balance▶

Get the current account balance, available funds, and pending payouts.

{}

Security: Use Restricted API Keys:

Stripe strongly recommends using Restricted API Keys (rk_*) instead of secret keys. Create a RAK with only the permissions your AI agent requires at dashboard.stripe.com/apikeys. Tool availability is automatically determined by the permissions on your restricted key.

Installation

{
  "mcpServers": {
    "stripe": {
      "type": "http",
      "url": "https://mcp.stripe.com"
    }
  }
}

Stripe Agent Toolkit

In addition to the MCP server, Stripe provides the Stripe Agent Toolkit for direct framework integration with OpenAI Agents SDK, LangChain, CrewAI, and Vercel AI SDK:

from stripe_agent_toolkit.openai.toolkit import create_stripe_agent_toolkit

async def main():
    toolkit = await create_stripe_agent_toolkit(
        secret_key="rk_test_..."
    )
    tools = toolkit.get_tools()

Documentation:

See the full Stripe MCP documentation at docs.stripe.com/mcp for a complete list of supported methods and configuration options.

Security

Remote MCP server uses OAuth — no API keys stored in local config files
Restricted API Keys (rk_*) provide granular tool-level permissions
Tool availability automatically scoped to key permissions
All communication encrypted via HTTPS
SECURITY.md in the repo with vulnerability reporting process

Stripe MCP Server