Stripe MCP

Overview

Stripe MCP provides access to Stripe's payment platform, enabling AI agents to manage customers, subscriptions, invoices, and payment methods. Perfect for building payment features, debugging billing issues, and managing Stripe operations.

Features

• Customer Management: Create, update, and search customers
• Subscription Management: Create and manage subscriptions
• Invoice Operations: Create, finalize, and send invoices
• Payment Methods: List and manage payment methods
• Product Catalog: Manage products and prices
• Dispute Handling: View and manage chargebacks
• Analytics: Access billing metrics and reports

Installation

npx -y @modelcontextprotocol/server-stripe

Configuration

Add to your Claude Desktop config:

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-stripe"],
      "env": {
        "STRIPE_SECRET_KEY": "sk_live_your-secret-key"
      }
    }
  }
}

Getting API Credentials

1. Go to Stripe Dashboard > Developers > API keys
2. Copy your secret key (start with sk_live_ or sk_test_)
3. For test mode, use sk_test_ keys

Available Tools

Tool	Description
create_customer	Create a new customer
get_customer	Get a customer by ID
list_customers	List customers with filters
create_product	Create a product
create_price	Create a price for a product
create_subscription	Create a subscription
get_invoice	Get an invoice by ID
create_invoice	Create a draft invoice
finalize_invoice	Finalize a draft invoice
send_invoice	Send an invoice to a customer
list_payment_methods	List payment methods for a customer
create_refund	Create a refund

Usage Examples

Customer Management

Create customer with email "user@example.com" and name "John Doe"

Get customer "cus_abc123"

List all customers created in the last 30 days

Product and Pricing

Create product "Premium Plan" with description "Monthly premium subscription"

Create price for product "prod_abc123" at $29.99/month

Subscription Management

Create subscription for customer "cus_abc123" with price "price_abc123"

Cancel subscription "sub_abc123" at period end

Invoice Operations

Create invoice for customer "cus_abc123" with line item $49.99

Finalize and send invoice "in_abc123"

Claude Desktop Setup

1. Install the MCP server
2. Add configuration to claude_desktop_config.json
3. Restart Claude Desktop
4. The Stripe tool will appear in your available tools

Security Considerations

• Use test keys (sk_test_) for development
• Use live keys (sk_live_) only in production
• Never commit API keys to version control
• Use Stripe's restricted keys for limited permissions
• Enable 2FA on your Stripe account

Use Cases

• Payment Debugging: Investigate failed payments and subscriptions
• Customer Support: Look up customer billing history
• Subscription Management: Handle upgrades, downgrades, cancellations
• Invoice Generation: Create and send invoices programmatically
• Revenue Analysis: Query billing data for reporting

Pros

• ✅ Full Stripe API access
• ✅ Great for payment debugging
• ✅ Customer and subscription management
• ✅ Invoice automation
• ✅ Works with test and live modes

Cons

• ❌ Requires Stripe API key with appropriate permissions
• ❌ Sensitive financial data access
• ❌ Some operations require Stripe Dashboard confirmation
• ❌ Rate limits apply for high-volume operations

Resources

• Stripe Documentation
• Stripe API Reference
• Stripe Dashboard
• MCP Server Source