What can you do with framedash mcp server?

@framedash/mcp-server

MCP (Model Context Protocol) server for the Framedash game telemetry platform. Provides 12 read-only tools and 4 resources for querying analytics data from LLM-powered tools.

Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "framedash": {
      "command": "npx",
      "args": ["@framedash/mcp-server"],
      "env": {
        "FRAMEDASH_API_KEY": "fd_xxx",
        "FRAMEDASH_PROJECT_ID": "your-project-uuid"
      }
    }
  }
}

VS Code (Claude Extension)

Add to your VS Code settings:

{
  "claude.mcpServers": {
    "framedash": {
      "command": "npx",
      "args": ["@framedash/mcp-server"],
      "env": {
        "FRAMEDASH_API_KEY": "fd_xxx",
        "FRAMEDASH_PROJECT_ID": "your-project-uuid"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
`FRAMEDASH_API_KEY`	Yes	API key with `analytics:read` for the aggregate tools; the raw `query` tool additionally requires `data:admin`
`FRAMEDASH_PROJECT_ID`	No	Default project UUID for project-scoped tools
`FRAMEDASH_BASE_URL`	No	API base URL (default: `https://app.framedash.dev`)

If FRAMEDASH_PROJECT_ID is omitted, project-scoped tools still work but require an explicit project_id argument per call.

Tools

Tool	Description
`query`	Execute SQL analytics query (SELECT only, limit default 100)
`get_dashboard`	Project KPI summary (DAU, MAU, sessions, 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`	Show the project bound to the API key
`get_project_status`	Project health overview
`list_maps`	List maps in a project
`list_content`	List content registry entries
`list_alerts`	List alert rules
`get_alert_history`	Alert trigger history

Resources

URI	Description
`framedash://projects`	Project bound to the API key
`framedash://projects/{projectId}/maps`	Map list with bounds
`framedash://projects/{projectId}/content`	Content registry
`framedash://projects/{projectId}/status`	Project health status

Development

Run from the repository root:

pnpm install
pnpm --filter @framedash/mcp-server... build
pnpm --filter @framedash/mcp-server test

With pnpm 9, the trailing ... selects the MCP package plus its workspace dependencies, including @framedash/api-client, before compiling from a clean checkout.

License

MIT

Install

Add framedash mcp server to your client. Pick the one you use.

claude mcp add mcp-server -- npx -y @framedash/mcp-server

codex mcp add mcp-server -- npx -y @framedash/mcp-server

amp mcp add mcp-server -- npx -y @framedash/mcp-server

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

Add to `claude_desktop_config.json`, then restart Claude Desktop.

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

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

code --add-mcp '{"name":"mcp-server","command":"npx","args":["-y","@framedash/mcp-server"]}'

Or add the block manually to `.vscode/mcp.json` under `servers`.

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

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

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

Add to `cline_mcp_settings.json` via the MCP Servers panel.

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

Add to `~/.gemini/settings.json`.

{
  "mcpServers": {
    "mcp-server": {
      "type": "local",
      "command": "npx",
      "args": [
        "-y",
        "@framedash/mcp-server"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.

{
  "context_servers": {
    "mcp-server": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@framedash/mcp-server"
        ]
      }
    }
  }
}

Add to your Zed `settings.json`.

npx -y @framedash/mcp-server

Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.

11 tools

framedash mcp server exposes 11 tools to a connected agent.

get_dashboard: Project KPI summary (DAU, MAU, sessions, 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: Show the project bound to the API key
get_project_status: Project health overview
list_maps: List maps in a project
list_content: List content registry entries
list_alerts: List alert rules
get_alert_history: Alert trigger history

Score

67 / 100

Good

Documentation22/25
Maintenance16/25
Trust6/20
Capability11/15
Install experience12/15

Documents what it does and how to connect
Has a resolvable package or endpoint
Exposes at least one tool, prompt or resource
README has substantive content
Includes a code example
Documents its configuration
Mentions credentials or security posture
Last commit 46 days ago
Has a release history
Repository is not archived
No licence detected
Namespace verified in the official MCP registry
Claimed by its owner
Published under an organisation
11 tool(s) documented
Provides prompt templates
Provides resources
12 documented install method(s)
Published to a package registry
Offers a hosted endpoint — no local install

Read the full rubric →

Version history

Versions	Published
0.1.3Latest	Jul 16, 2026