mcp-stripe-analytics

Connect Claude to your Stripe dashboard. Revenue, customers, subscriptions -- all from chat.

Install

Add to your .mcp.json:

config.json

{
  "mcpServers": {
    "stripe-analytics": {
      "command": "npx",
      "args": ["-y", "mcp-stripe-analytics"],
      "env": {
        "STRIPE_SECRET_KEY": "sk_live_..."
      }
    }
  }
}

Tools

get_revenue_summary

Get gross revenue, fees, net revenue, and transaction count for a period.

Code

get_revenue_summary({ period: "month" })
// => { gross: 12450.00, fees: 361.05, net: 12088.95, count: 187 }

Params: period — "today" | "week" | "month" | "year" (default: "month")

get_customer_count

Total customers and new customers added in a period.

Code

get_customer_count({ period: "week" })
// => { total: 1243, new_in_period: 38 }

Params: period — "today" | "week" | "month" | "year" (default: "month")

get_subscription_metrics

Breakdown of subscription statuses: active, trialing, past_due, canceled.

Code

get_subscription_metrics()
// => { active: 412, trialing: 27, past_due: 8, canceled: 63 }

Params: None

get_top_customers

Top N customers ranked by lifetime spend.

Code

get_top_customers({ limit: 5 })
// => [{ email: "whale@co.com", name: "Whale Corp", total_spent: 8420.00 }, ...]

Params: limit — number (default: 10)

get_recent_charges

List recent charges with amount, status, and customer info.

Code

get_recent_charges({ limit: 10, status: "failed" })
// => [{ id: "ch_...", amount: 49.00, status: "failed", customer_email: "..." }, ...]

Params: limit — number (default: 20), status — "succeeded" | "failed" | "all" (default: "all")

get_refund_summary

Refund count and total amount for a period.

Code

get_refund_summary({ period: "month" })
// => { count: 4, total: 196.00 }

Params: period — "today" | "week" | "month" | "year" (default: "month")

get_product_revenue

Revenue breakdown grouped by product.

Code

get_product_revenue({ period: "month" })
// => [{ product: "Pro Plan", revenue: 7800.00, count: 156 }, ...]

Params: period — "today" | "week" | "month" | "year" (default: "month")

get_mrr

Monthly Recurring Revenue calculated from all active subscriptions.

Code

get_mrr()
// => { mrr: 4120.50, active_subscriptions: 412 }

Params: None

Security

This server uses read-only Stripe API calls only. It never creates, updates, or deletes any Stripe resources. Your billing data is safe.

Use a restricted API key with read-only permissions for maximum security.

Built by

THRYXAGI -- AI-native tools for builders.