Skip to main content
Glama
indie-metrics-mcp

indie-metrics-mcp

by MARCCHERGGI

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

get_revenue_summary

MRR, ARR, total revenue, growth rate, average transaction value

get_customer_metrics

Total customers, new customers, LTV, top spenders

get_product_performance

Revenue by product, units sold, revenue share

get_subscription_health

Active subscriptions, churn rate, MRR, ARPU, plan breakdown

get_recent_transactions

Latest charges with amount, status, customer, timestamp

get_refund_analysis

Refund count, rate, amounts, reasons

get_revenue_forecast

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 build

Configure 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_here

Add 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 build

A 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 tools
get_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

    A4/5.0

    Scored across 7 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Open-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.
      -
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that enables AI assistants to query databases, execute SQL, and manage Metabase resources like dashboards, cards, and collections through natural language.
      22
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An 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.
      5
      5 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that enables AI agents to query RevenueCat's subscription analytics API using natural language, retrieving metrics like MRR, churn, and revenue.
      3
      9 npm
      MIT