Interactive Demo

Charts API Explorer

Try it with mock data — no API key required

Chart

Resolution

Segment By

Date Range

Revenue

DEMO MODE

GET /api/demo/revenue?resolution=weekly&start_date=2025-09-01&end_date=2026-03-15

View JSON Response

// Click "Query Chart" to see response

Architecture

How It Works

1️⃣

AI Agent Sends Query

User asks their AI agent a question like "What's our churn rate trend?" The agent recognizes this needs subscription data and calls the MCP tool.

query_chart({
  "chart_name": "churn",
  "start_date": "2025-10-01",
  "end_date": "2026-03-15",
  "resolution": "monthly"
})

2️⃣

MCP Server Calls Charts API

The MCP Server authenticates with your RevenueCat API key and forwards the request to the Charts API v2, handling pagination and rate limits.

GET /v2/projects/{pid}/charts/churn
Authorization: Bearer sk_xxx
?resolution=monthly
&start_date=2025-10-01
&end_date=2026-03-15

3️⃣

Agent Analyzes & Reports

The agent receives structured time-series data, performs analysis, identifies trends, and returns an actionable summary in natural language.

// Agent's analysis:
📉 Churn decreased from 5.8% to 3.2%
🎯 45% improvement over 6 months
💡 Biggest drop after paywall redesign
   in December (5.1% → 3.8%)

MCP Tools

Three Tools, Complete Coverage

📊

query_chart

Query any chart with date ranges, resolution, segmentation, and filters. Returns time-series data for revenue, MRR, churn, subscribers, and more.

Params: chart_name, start_date, end_date, resolution, segment_by

⚙️

get_chart_options

Discover available filters, segments, and resolutions for any chart. Enables agents to self-discover capabilities without hardcoded knowledge.

Params: chart_name

📋

list_charts

List all available chart types with names and descriptions. Agents can understand what analytics are available before querying.

Params: none

5 Minutes

Quick Start

Step 1: Add to your Claude Code config

// ~/.claude/mcp_servers.json
{
  "revenuecat-charts": {
    "command": "npx",
    "args": ["revenuecat-charts-mcp"],
    "env": {
      "REVENUECAT_API_KEY": "sk_your_secret_key",
      "REVENUECAT_PROJECT_ID": "proj1ab2c3d4"
    }
  }
}

Step 2: Try demo mode (no API key needed)

// Set DEMO_MODE=true for mock data
{
  "revenuecat-charts": {
    "command": "npx",
    "args": ["revenuecat-charts-mcp"],
    "env": {
      "DEMO_MODE": "true"
    }
  }
}

Step 3: Ask your agent

💬 "What's our MRR this month vs last month?"
💬 "Show churn by country for the past quarter"
💬 "How many new trials did we start this week?"
💬 "Compare revenue across iOS, Android, and Web"

Your AI Agent Needs Subscription Analytics