Stripe MCP Server for Claude

1. Run: claude mcp add --transport http stripe https://mcp.stripe.com
2. Verify installation: claude mcp list
3. Test connection: claude mcp status stripe
4. Configure your Stripe API key (sk_test_ for test mode, sk_live_ for live mode)
5. Authenticate with your Stripe account

1. Open Claude Desktop configuration file (see configPath below)
2. Add the Stripe server configuration with HTTP transport and URL
3. Restart Claude Desktop
4. Configure your Stripe API key (sk_test_ for test mode, sk_live_ for live mode)
5. Authenticate with your Stripe account
6. Verify connection in Claude Desktop

Process full or partial refunds for payments. Include reasons and metadata for tracking. Stripe automatically handles failed payment recovery.

// Full refund for a payment
"Refund payment pi_1234567890 completely"

// Partial refund with reason
"Issue a $25 partial refund for payment pi_1234567890 with reason: customer_request"

// Refund with metadata
"Refund payment pi_1234567890 and add metadata: support_ticket=TICKET-123"

Manage customer subscriptions including upgrades, downgrades, and cancellations. Control billing cycles and proration settings.

// List active subscriptions
"Show all active subscriptions for customer cus_abc123"

// Update subscription plan
"Upgrade customer cus_abc123 from price_basic to price_premium starting next billing cycle"

// Cancel subscription
"Cancel subscription sub_xyz at period end"

Generate revenue reports, analyze payment trends, and identify failed transactions. Essential for financial reporting and business intelligence.

// Monthly revenue report
"Show total revenue and transaction count for September 2024"

// Revenue by product
"Break down revenue by product for the last quarter"

// Failed payment analysis
"List all failed payments in the last 30 days with reasons"

Manage invoices, send payment reminders, and track customer payment history. Automate billing workflows for B2B customers.

// Create invoice
"Create an invoice for customer cus_abc123 with items:
- price_item1 x 2
- price_item2 x 1
Due in 14 days"

// Send invoice reminder
"Send payment reminder for invoice in_xyz to customer"

// View customer payment history
"Show all payments for customer cus_abc123 in the last 6 months"

Manage customer payment methods including cards, bank accounts, and wallets. Update default methods and clean up expired entries.

// List customer payment methods
"Show all payment methods for customer cus_abc123"

// Set default payment method
"Set payment method pm_xyz as default for customer cus_abc123"

// Remove expired cards
"List and remove all expired payment methods"

Monitor webhook events, retry failed deliveries, and track integration health. Essential for maintaining reliable payment processing.

// List recent events
"Show recent webhook events for type payment_intent.succeeded"

// Retry failed webhooks
"Retry failed webhook deliveries from the last 24 hours"

// Monitor webhook health
"Show webhook endpoint health status and delivery success rate"

Create a new Stripe payment intent with amount and currency

// Create Stripe payment intent
const paymentIntent = await stripe.paymentIntents.create({
  amount: 2000,
  currency: "usd",
  payment_method_types: ["card"],
  metadata: { order_id: "order_123" }
});