Skip to main content
Glama
roblox-analytics-mcp

roblox-analytics-mcp

by frrazer

roblox-analytics-mcp

A local MCP server that lets AI agents (Claude Code, Codex, etc.) query Roblox experience analytics — DAU, revenue, retention, playtime, crash rates, funnels, custom events, data store usage, and more — through the Open Cloud Analytics API.

Runs entirely on your machine. Your API key is stored locally and never leaves your computer.

Tools

Tool

What it does

list_metrics

Browse the ~150 supported metrics with their exact names, categories, supported granularities, retention windows, and supported dimensions. Filter by category or keyword.

query_metrics

Query a metric time series for a universe: pick a granularity (OneMinute … OneMonth, or None for one total), a date range, optional breakdown dimensions and filters.

list_dimension_values

Discover which values a dimension actually has (countries, platforms, funnel names, custom event names, place IDs, …) for a metric and date range.

get_operation

Poll a slow query that came back with done: false.

Slow queries are polled automatically for up to 60 seconds (configurable via pollTimeoutSeconds). If a query still isn't finished, the pending operation's path is returned so the agent can call get_operation later.

Metric categories

Retention, Engagement, Monetization, Acquisition, Performance, Economy, Funnels, CustomEvents, Thumbnails, SpeechToText, TextToSpeech, Matchmaking, DataStore, MemoryStore, Safety, Advertising.

Standard metrics keep ~4 years of data; performance, data store, and memory store metrics keep 28 days; matchmaking keeps 90 days. Ranges longer than two years only support OneWeek, OneMonth, or None.

Example prompts

  • "What was my DAU by platform for the last 30 days in universe 123456?"

  • "Compare revenue by country for August vs September."

  • "Which funnel steps have the highest churn in my onboarding funnel?"

  • "Show client crash rate per hour for the last 24 hours, broken down by PlaceVersion."

Related MCP server: Google Analytics MCP Server

Setup

1. Get an Open Cloud API key

  1. Go to the Creator Dashboard → Open Cloud → API Keys.

  2. Create a key and add the universe-analytics API system.

  3. Give it the universe.analytics:read scope for the universes you want to query.

This key only needs read access to analytics — nothing else.

2. Install

npm install -g @frrazers/roblox-analytics-mcp

(Or clone this repo and run npm install && npm run build, then use node dist/cli.js as the command.)

3. Store your key

roblox-analytics-mcp setup

This prompts for your key (hidden input) and saves it to your OS config directory. No secrets end up in any shared config file. Check it worked with:

roblox-analytics-mcp status

4. Connect it to Claude Code

Either register it:

claude mcp add roblox-analytics -- roblox-analytics-mcp

or add a .mcp.json to your project (safe to commit — it contains no secret):

{
  "mcpServers": {
    "roblox-analytics": {
      "command": "roblox-analytics-mcp"
    }
  }
}

The tools appear as mcp__roblox-analytics__* in your next session; /mcp shows status.

Remote server for claude.ai (custom connector)

claude.ai (web, desktop, mobile) can't run local stdio servers, only remote ones over HTTP. The worker/ directory is the same four tools served over MCP Streamable HTTP from a Cloudflare Worker.

cd worker
npm install
npx wrangler deploy
echo "<your Open Cloud key>" | npx wrangler secret put ROBLOX_API_KEY
echo "<a long random string>" | npx wrangler secret put MCP_SECRET

The endpoint is https://<worker>.workers.dev/mcp/<MCP_SECRET>. Add it in claude.ai under Customize → Connectors → Add custom connector with no OAuth settings.

Custom connectors only support OAuth or no auth, so the secret path is the access control: anyone with the full URL can query the universes that key is scoped to (read-only). Rotate it by putting a new MCP_SECRET. Long queries are capped at 25 s of polling per tool call; the agent resumes with get_operation if a query is still running.

Managing your key

Command

Action

roblox-analytics-mcp setup

Store or replace the key

roblox-analytics-mcp setup --clear

Delete the stored key

roblox-analytics-mcp status

Show whether a key is configured and where it came from

A key stored by setup takes precedence. If you haven't run setup, the ROBLOX_API_KEY environment variable is used as a fallback (handy for CI).

Notes on the API

  • Metric names are case-sensitive (DailyActiveUsers, not dailyactiveusers). The server warns you before sending if a name, granularity, or dimension doesn't match its local catalog, but still forwards the request in case the catalog is behind the live API.

  • startTime is inclusive and endTime is exclusive, both RFC 3339 UTC.

  • A 429 with code 3000 means the data-point budget was exceeded: shorten the range, coarsen the granularity, or reduce breakdowns.

License

MIT

Available Tools

4 tools
get_operationA

Check on a long-running analytics query. Use this when query_metrics or list_dimension_values returned done: false; pass the 'path' from that response. Returns the operation with 'done' and, once finished, the 'response' payload.

Inputs: path (required).

list_dimension_valuesA

Discover the actual values a dimension takes for a metric in a universe over a date range, e.g. which Country codes, Platform names, FunnelName values, CustomEventName values, or Place IDs have data. Use the returned values in query_metrics filters or to understand breakdown results. Returns { values: [{ dimension, values: [{ value }] }] }.

Inputs: metric (required), endTime (required), startTime (required), dimensions (required), +5 more.

list_metricsA

List the analytics metrics you can query, with each metric's exact (case-sensitive) name, human label, category, supported granularities, data retention in days, and supported breakdown/filter dimensions. Call this first to pick a metric and check which granularity and dimensions it accepts. Filter by category or search by keyword to keep the output small.

Inputs: search, category.

query_metricsA

Query a time series for one analytics metric of a Roblox universe (experience): DAU, revenue, retention, playtime, crash rate, funnels, custom events, and more. Returns data points bucketed by granularity, optionally broken down by dimensions (e.g. Platform, Country) and filtered. Each data point has a UTC 'time', a numeric 'value' (or 'stringValues' for text metrics), and may carry a 'status' of Valid, Projected, or NotStatisticallySignificant. Slow queries are polled automatically; if the response has done: false, call get_operation with its 'path'. Requires an API key with the universe.analytics:read scope.

Inputs: metric (required), endTime (required), startTime (required), universeId (required), +5 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a distinct responsibility: listing available metrics, querying metric time series, discovering dimension values, and polling async operations. There is no overlap in purpose; descriptions clearly separate the two data-retrieval tools.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (list_metrics, query_metrics, list_dimension_values, get_operation). The naming style is uniform and predictable.

    Tool Count5/5

    Four tools is an appropriate size for an analytics-focused server: discovery, query, dimension exploration, and async operation handling cover the necessary workflow without bloat. Each tool earns its place.

    Completeness5/5

    The set covers the full analytics query lifecycle: find a metric, inspect its dimensions, run the query, and retrieve results for long-running operations. There are no obvious dead ends or missing core capabilities.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to query a privacy-focused analytics service for aggregate stats, breakdowns, realtime visitors, and time-series trends across cloud or self-hosted deployments. It also provides connectivity checks and guided analytics playbooks.
      8
      MIT