Skip to content
MCP server

Framedash MCP Server

Query Framedash game telemetry, heatmaps and alerts from an AI assistant

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally
Version
0.2.1
Listing updated
3 days ago

About Framedash MCP Server

Framedash MCP Server is a freemium MCP server for analytics and data. It runs locally on your machine and is started by your AI client.

Framedash is a Japanese-language game telemetry service for Unity, Unreal Engine 5 and Godot (C#) that records frame time, GPU time and memory and overlays them on a game map as heatmaps, then compares builds to catch regressions before release. This server gives an assistant read-only access to that data.

Twelve tools cover a project KPI summary, retention cohorts, funnels, event insights, heatmap grids, maps, the content registry, alert rules and alert history. A raw SQL query tool accepts SELECT only and needs an API key with an extra data:admin scope, while the aggregate tools need analytics:read. Four resources expose the project, its maps, its content and its status. Set FRAMEDASH_PROJECT_ID for a default project, or pass project_id on each call.

The npm package runs over stdio and is MIT licensed. The hosted HTTP endpoint rejects request batches of more than 100 messages.

Install

Run in a terminal

claude mcp add framedash-mcp-server --env FRAMEDASH_API_KEY='<FRAMEDASH_API_KEY>' -- npx -y @framedash/mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "framedash-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@framedash/mcp-server"
      ],
      "env": {
        "FRAMEDASH_API_KEY": "<FRAMEDASH_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "framedash-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@framedash/mcp-server"
      ],
      "env": {
        "FRAMEDASH_API_KEY": "<FRAMEDASH_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "framedash-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@framedash/mcp-server"
      ],
      "env": {
        "FRAMEDASH_API_KEY": "<FRAMEDASH_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "framedash-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@framedash/mcp-server"
      ],
      "env": {
        "FRAMEDASH_API_KEY": "<FRAMEDASH_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "framedash-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@framedash/mcp-server"
      ],
      "env": {
        "FRAMEDASH_API_KEY": "<FRAMEDASH_API_KEY>"
      }
    }
  }
}

Configuration

  • FRAMEDASH_API_KEYFramedash API key. Create one on your project's API Keys page at https://app.framedash.dev.Required
  • FRAMEDASH_PROJECT_IDDefault project id. When unset, project-scoped tools require a project_id argument.
  • FRAMEDASH_BASE_URLAPI base URL. Defaults to https://app.framedash.dev.

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

query
Executes a SELECT-only SQL analytics query.
get_dashboard
Project KPI summary including DAU, MAU, sessions and events.
get_retention
Cohort retention data.
get_funnel
Funnel analysis for event steps.
get_insights
Event insights with grouping.
get_heatmap
Heatmap grid data for a map.
list_projects
Shows the project bound to the API key.
get_project_status
Project health overview.
list_maps
Lists maps in a project.
list_content
Lists content registry entries.
list_alerts
Lists alert rules.
get_alert_history
Alert trigger history.

What it does

12 read-only tools
Analytics, retention, funnels, heatmaps, maps, content and alerts.
Raw SQL queries
SELECT-only queries with a default limit, behind an extra key scope.
Heatmap data
Fetch grid data for a map to find performance hotspots.
Alert history
See which threshold alerts fired and when.
Project resources
Four resources expose projects, maps, content and status.
Scoped keys
analytics:read for aggregates, data:admin for raw queries.

Good for

  • Ask which build regressed P95 frame time
  • Compare retention cohorts after an update
  • Pull heatmap data for a level to find slow areas
  • Check recent alert triggers for a project
  • Run an ad hoc SQL query on game events

Pricing

Freemium

Framedash has a free plan with one project and paid tiers; tier prices are not shown.

Prices change. Check framedash.dev before you buy.

Framedash MCP Server FAQ

Is it read-only?

Yes. All 12 tools only read data.

What API key do I need?

One with analytics:read; the raw query tool also needs data:admin.

Which engines does Framedash support?

Unity 2022.3+, Unreal Engine 5.3+ and Godot 4.3+ (C#).

What licence is the server?

MIT.

Is Framedash MCP Server free?

Framedash MCP Server has a free plan, with paid plans for more usage or features.

How do I add Framedash MCP Server to Claude Code?

Run this command in your terminal: claude mcp add framedash-mcp-server --env FRAMEDASH_API_KEY='<FRAMEDASH_API_KEY>' -- npx -y @framedash/mcp-server

What are the best alternatives to Framedash MCP Server?

The closest alternatives to Framedash MCP Server are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

Alternatives to Framedash MCP Server

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data