indie-metrics-mcp
This MCP server provides AI assistants with read-only access to Stripe business metrics, enabling natural language queries about revenue, customers, subscriptions, refunds, and forecasts. Key capabilities include:
Revenue Summary: MRR, ARR, total revenue, growth rate, and average transaction value for configurable periods (7d, 30d, 90d, 1y).
Customer Metrics: Total customers, new customers, average lifetime value, and top spenders.
Product Performance: Revenue by product, units sold, average price, and revenue share to identify best and worst sellers.
Subscription Health: Active subscriptions, churn rate, MRR, ARPU, new vs. canceled subscriptions, and plan breakdowns.
Recent Transactions: Charges and payments with amount, status, customer email, description, and timestamp.
Refund Analysis: Refund counts, amounts, refund rate, and reasons.
Revenue Forecast: Projected MRR/ARR based on trends, with growth direction and confidence level.
Provides tools for querying Stripe business metrics such as MRR, ARR, revenue, customer metrics, product performance, subscription health, recent transactions, refund analysis, and revenue forecasts via natural language.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@indie-metrics-mcp What's my MRR for this month?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
indie-metrics-mcp
MCP server that gives an AI assistant read-only access to Stripe business metrics. Ask an MCP-compatible client about revenue, customers, subscriptions, refunds, and forecasts in natural language.
What You Can Ask
"What's my MRR this month?"
"Show me my top customers by spend"
"Which product is selling best?"
"What's my churn rate?"
"Show recent transactions"
"How many refunds did I have this quarter?"
"Forecast my revenue for next month"
Related MCP server: Metabase MCP Plus
Tools
Tool | Description |
| MRR, ARR, total revenue, growth rate, average transaction value |
| Total customers, new customers, LTV, top spenders |
| Revenue by product, units sold, revenue share |
| Active subscriptions, churn rate, MRR, ARPU, plan breakdown |
| Latest charges with amount, status, customer, timestamp |
| Refund count, rate, amounts, reasons |
| Projected revenue, trend direction, confidence level |
Install From Source
The npm package is not claimed as published. Use the tagged source release until an npm package is independently confirmed.
git clone https://github.com/MARCCHERGGI/indie-metrics-mcp.git
cd indie-metrics-mcp
npm ci
npm run buildConfigure Safely
Start with a Stripe test-mode restricted key. Grant only the read permissions required by the tools you plan to use. Never commit a key, paste it into an issue, or expose it to a hosted demo.
export STRIPE_API_KEY=sk_test_your_restricted_key_hereAdd to an MCP-compatible desktop client
Point the client at the locally built executable:
{
"mcpServers": {
"indie-metrics": {
"command": "node",
"args": ["/absolute/path/to/indie-metrics-mcp/dist/index.js"],
"env": {
"STRIPE_API_KEY": "sk_test_your_restricted_key_here"
}
}
}
}Use your client's secure environment-variable or secret-management feature when available instead of storing credentials directly in a configuration file.
Supported Periods
All time-based tools accept a period parameter: 7d, 30d, 90d, or 1y.
Security Boundaries
The server is designed for local execution.
Tool operations are read-only with respect to Stripe.
Start in Stripe test mode and use a restricted key with least privilege.
Do not connect real customer data to public demonstrations.
Forecasts are estimates, not financial advice.
Review the source and permissions before using the server with production data.
Public Reproducibility Companion
FounderMetricBench is a separate public synthetic evaluation maintained by Marco Hergi. It contains 24 gold cases for routing, calculation, retrieval, and safety, plus stable evidence fixtures and a hosted synthetic MCP endpoint. It does not use this repository's users, credentials, or real Stripe data.
This repository and the companion site are independent projects. They are not produced, sponsored, certified, or endorsed by Stripe, Anthropic, OpenAI, Google, Microsoft, or Perplexity.
Release Verification
Before publishing a release, run:
npm ci
npm run buildA release should describe known limitations and link to the exact commit or tag it represents.
License and Attribution
MIT. See LICENSE. Existing copyright and authorship notices are preserved.
Available Tools
7 toolsget_customer_metricsCustomer MetricsA
Get customer analytics including total customers, new customers in period, average lifetime value (LTV), and top customers by spend.
Inputs: period, limit.
get_product_performanceProduct PerformanceB
Analyze revenue by product — shows each product's revenue, units sold, average price, and share of total revenue. Identifies your best and worst sellers.
Inputs: period.
get_recent_transactionsRecent TransactionsA
List recent charges and payments with amount, status, customer email, description, and timestamp. Great for checking latest sales activity.
Inputs: limit.
get_refund_analysisRefund AnalysisA
Analyze refunds: total count, amount, refund rate vs successful charges, and details of recent refunds including reasons. Helps identify product issues.
Inputs: period.
get_revenue_forecastRevenue ForecastA
Predict future revenue based on recent trends. Shows current MRR, projected monthly and annual revenue, growth trend direction, and confidence level. Uses 3-month rolling analysis.
Inputs: no named parameters.
get_revenue_summaryRevenue SummaryB
Get a complete revenue overview including MRR, ARR, total revenue, transaction count, average transaction value, and period-over-period growth rate. Supports periods: 7d, 30d, 90d, 1y.
Inputs: period.
get_subscription_healthSubscription HealthA
Full subscription analytics: active subscriptions, churn rate, MRR, ARPU, new vs canceled subscriptions, and breakdown by plan. Essential for SaaS metrics.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct aspect of business metrics: customers, products, transactions, refunds, revenue forecast, revenue summary, and subscriptions. There is minimal overlap, and descriptions clearly differentiate them.
All tool names follow a consistent 'get_' prefix followed by a descriptive noun phrase (e.g., get_customer_metrics, get_revenue_summary), making them predictable and easy to understand.
With 7 tools, the server covers key analytical areas without being overwhelming. The count is appropriate for a focused metrics server, each tool earning its place.
The tool set covers core SaaS metrics like revenue, customers, products, transactions, refunds, and subscriptions. Missing advanced features like cohort analysis or funnel metrics, but the surface is largely complete for typical use.
Maintenance
Related MCP Connectors
The Ramp MCP server enables users to securely connect Ramp with AI assistants like ChatGPT and Claude to query financial data and take actions using natural language. It transforms Ramp's developer API into a SQL interface that LLMs can query, allowing admins to analyze spend trends, identify cost savings, and run complex SQL analyses on comprehensive datasets (transactions, purchase orders, vendors, users), while all users can manage cards, view transactions, request reimbursements, and get expense policy answers.
MerchantFlow is a hosted, read-only ecommerce analytics MCP server for Shopify and WooCommerce. It gives AI assistants tenant-scoped access to revenue, profit and loss, product and SKU profitability, COGS coverage, fulfillment costs, advertising spend, ROAS, marketing performance, cohorts, LTV, and business valuation across connected commerce and marketing platforms. Connect with OAuth over Streamable HTTP. No local server installation is required.
Hosted Stripe MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceOpen-source MCP server for Claude AI that connects Stripe and Supabase to enable natural language SaaS analytics, including churn analysis, subscription tracking, and revenue insights.-
- AlicenseAqualityDmaintenanceAn MCP server that enables AI assistants to query databases, execute SQL, and manage Metabase resources like dashboards, cards, and collections through natural language.22MIT
- AlicenseAqualityDmaintenanceAn MCP server that gives AI agents access to RevenueCat's Charts & Metrics API. Query MRR, churn, trial conversion, revenue, and 17 more subscription metrics directly from Claude, Cursor, or any MCP client.55 npmMIT
- AlicenseAqualityDmaintenanceAn MCP server that enables AI agents to query RevenueCat's subscription analytics API using natural language, retrieving metrics like MRR, churn, and revenue.39 npmMIT