io.github.lordbasilaiassistant-sudo/stripe-analytics
Stripe analytics — revenue, customers, subscriptions, refunds, churn from Claude.
Open source Open in the app JSON README (API)
About
Stripe analytics — revenue, customers, subscriptions, refunds, churn from Claude.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- lordbasilaiassistant-sudo
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.1
- Stars
- 1
- Last push
- 2026-03-07T14:44:51Z
- Repository state
- arquivado
- Language
- JavaScript
- Added
- 2026-08-29 04:00:26
- Updated
- 2026-08-29 04:00:26
- Origin id
io.github.lordbasilaiassistant-sudo/stripe-analytics
README
# mcp-stripe-analytics
Connect Claude to your Stripe dashboard. Revenue, customers, subscriptions -- all from chat.
## Install
Add to your `.mcp.json`:
```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.
```
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.
```
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.
```
get_subscription_metrics()
// => { active: 412, trialing: 27, past_due: 8, canceled: 63 }
```
**Params:** None
### get_top_customers
Top N customers ranked by lifetime spend.
```
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.
```
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.
```
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.
```
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.
```
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](https://dashboard.stripe.com/apikeys) with read-only permissions for maximum security.
## Built by
[THRYXAGI](https://github.com/lordbasilaiassistant-sudo) -- AI-native tools for builders.