List all available RevenueCat Charts API metrics with descriptions. Use this to discover what subscription data you can query before calling rc_get_chart.

Args:

• category (string): Filter by category — "all", "revenue", "actives", "trials", "conversion", or "cohorts" (default: "all")

Returns: Markdown-formatted list of metrics grouped by category, each with metric name (for use in rc_get_chart) and description.

Examples:

• "What metrics can I query?" -> category="all"

• "Show me revenue metrics" -> category="revenue"

• "What trial data is available?" -> category="trials"

Get a real-time snapshot of key subscription health metrics. No date range needed — returns current state.

Args:

• api_key (string): RevenueCat secret API key starting with "sk_"

• project_id (string, optional): RevenueCat project ID (e.g., "proj058a6330"). Auto-detected if omitted.

Returns: Markdown summary with: Active Trials, Active Subscriptions, MRR ($), Revenue (28d), New Customers (28d), Active Users (28d), Transactions (28d).

Examples:

• "What's my current MRR?" -> call with just api_key

• "Give me a subscription health check" -> call with just api_key

• "How many active subscribers do I have?" -> call with just api_key

Query any RevenueCat Charts API metric as a time series. Returns formatted markdown table with dates, measures, and summary statistics.

Supports 21 metrics across revenue, subscriptions, trials, conversion, and cohorts. Use rc_list_metrics to discover available metrics.

Args:

• api_key (string): RevenueCat secret API key starting with "sk_"

• metric (string): Chart metric name. Common values: "mrr", "revenue", "churn", "actives", "trials", "trial_conversion_rate", "ltv_per_customer"

• start_date (string): Start date in YYYY-MM-DD format

• end_date (string): End date in YYYY-MM-DD format

• resolution (string, optional): "day", "week", or "month" (default: "month")

• segment (string, optional): Dimension to segment by (e.g., "country")

• project_id (string, optional): RevenueCat project ID. Auto-detected if omitted.

Returns: Markdown with chart description, period, resolution, summary statistics, and a data table. Multi-measure charts (like churn) include all measures as columns. Segmented charts show top 10 segments as columns.

Examples:

• "Show me MRR for 2025" -> metric="mrr", start_date="2025-01-01", end_date="2025-12-31"

• "What's my churn week over week?" -> metric="churn", resolution="week"

• "Break down revenue by country" -> metric="revenue", segment="country"

• "How are trial conversions trending?" -> metric="trial_conversion_rate"

Error Handling:

• Invalid metric: returns list of valid metric names

• Rate limited: auto-retries up to 3 times with backoff

• Invalid date format: returns error with expected format