Skip to main content
Glama
srnyx
by srnyx

FastStats for Claude

A Claude Desktop extension (MCP server) that lets Claude design, validate and publish FastStats charts and dashboards for your projects.

Ask things like "make a dashboard showing how servers configure my plugin" and Claude will read your project's metrics, design the charts, test each one against your real data, and save them.

  • Nothing broken gets saved. Every chart is checked against your project's fields and dry-run with FastStats' preview endpoint before it is created or updated.

  • Your edits are safe. Updates never overwrite a chart that changed since Claude read it, and deleting anything needs explicit confirmation.

  • Read-only mode hides every tool that writes, if you only want Claude to look.

Install

  1. Download faststats-mcp.mcpb from the latest release.

  2. Double-click it, or drag it into Claude Desktop under Settings → Extensions, then click Install.

  3. Paste a FastStats API key when asked (create one on faststats.dev under Settings → API keys). It's stored in your system keychain and only sent to FastStats.

That's it: no Node.js, cloning or building needed. Claude Desktop runs the extension with its built-in Node runtime.

Settings

Setting

FastStats API key

Required. Only projects this key can access are visible to Claude.

Default project

Optional slug or id (e.g. my-plugin) used when you don't name a project.

Read-only mode

Hides create, update and delete tools.

Change them any time under Settings → Extensions → FastStats.

Related MCP server: iClips MCP Bridge

Tools

Tool

Writes

get_guide

Spec format, step reference, semantics, recipes

list_projects

Projects your key can access

get_project_context

Fields (built-in and custom metrics), dashboards, charts

get_chart

A chart as an editable spec

preview_chart

Validates and dry-runs a spec, returns a data sample

list_event_markers

Marker collections or their markers

list_data_sources

Custom metrics, optionally with event coverage and observed json paths

check_project_data

Whether the project is receiving data

get_anomalies

Metric health and incidents (spikes, shifts, gaps) with likely causes

get_download_analytics

Downloads per platform and version, plus linked listings

search_download_providers

Find a listing on Modrinth, Spigot, Hangar, Ore, CurseForge or GitHub

create_chart

✔

Previews first. Auto-placed on a 12-column grid.

update_chart

✔

Previews first. Never overwrites newer edits made in the FastStats UI.

delete_chart

✔

Requires explicit confirmation

create_dashboard

✔

Optionally with charts. All are previewed before anything is created.

create_event_marker

✔

e.g. releases to overlay on time series

bulk_create_event_markers

✔

Up to 500 at once; externalId makes re-runs update instead of duplicate

update_event_marker / update_marker_collection

✔

delete_event_marker / delete_marker_collection

✔

Require explicit confirmation

update_dashboard

✔

Name, description, public/private

delete_dashboard

✔

Requires explicit confirmation

duplicate_dashboard

✔

Within the project or into another one

reorder_dashboards

✔

link_download_provider

✔

Start tracking downloads from a listing

unlink_download_provider

✔

Requires explicit confirmation

create_data_source

✔

Registers a custom metric

update_data_source

✔

Refuses to rename a referenceId that charts use unless forced

delete_data_source

✔

Requires explicit confirmation; refuses while charts use it unless forced

How charts are described

Claude writes charts in a compact series spec (datasource → filter → groupBy → aggregate …), and the extension compiles it into FastStats' flow graph:

{
  "name": "Storage backends",
  "chartType": "pie",
  "outputs": [{
    "name": "Servers",
    "steps": [
      { "datasource": "internal:server_count" },
      { "groupBy": "storage.method" },
      { "aggregate": "count" },
      { "limit": 8, "groupOthers": true }
    ]
  }],
  "visual": { "pie": { "style": "donut", "showTotal": true } }
}

Nested keys of JSON metrics (like storage.method above) work as dot paths. See src/resources/guide.md for the full format and docs/FLOW_SCHEMA.md for the reverse-engineered FastStats schema.

Other MCP clients

The server is a single file, so any stdio MCP client can run it. Build it (see below), then point your client at dist/index.js:

{
  "mcpServers": {
    "faststats": {
      "command": "node",
      "args": ["C:\\path\\to\\faststats-mcp\\dist\\index.js"],
      "env": { "FASTSTATS_API_KEY": "your-key" }
    }
  }
}

env

default

FASTSTATS_API_KEY

required

Sent as x-api-key. Never logged or returned.

FASTSTATS_DEFAULT_PROJECT

none

Slug or id used when a tool call omits project.

FASTSTATS_READ_ONLY

false

true hides every tool that writes.

FASTSTATS_BASE_URL

https://api.faststats.dev

Development

Requires Node.js 22+.

npm install
npm run build          # bundles to dist\index.js (self-contained)
npm test               # unit tests (compiler, round-trip on real charts, grid, client, manifest)
npm run test:contract  # checks hard-coded enums against the live OpenAPI spec
npm run typecheck
npm run pack           # build + validate manifest + create faststats-mcp.mcpb
npm run inspect        # MCP Inspector against dist\index.js

To try a local build in Claude Desktop, run npm run pack and install the resulting faststats-mcp.mcpb.

Releasing

  1. Bump version in both package.json and manifest.json (a test fails if they differ), and commit.

  2. Publish a GitHub release whose tag is that version, e.g. 0.2.0 (no v).

GitHub Actions runs the checks, builds faststats-mcp.mcpb and attaches it to the release, so the download link above always points at the latest version.

License

MIT

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables Claude to read CRM data and propose actions (bid changes, budget shifts, etc.) via a thin authenticated router, without executing any changes.
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Connects iClips project data to Claude for agency capacity planning, exposing tools to monitor daily demand vs. capacity, stalled jobs, cascading off-work effects, and classification audits.
    -
  • A
    license
    A
    quality
    A
    maintenance
    Enables Claude Code to read, create, update, and delete Claude Cowork/claude.ai projects and their knowledge documents, including syncing local folders to projects, with safety features like backups and overwrite protection.
    17
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables Claude Code to securely interact with PostgreSQL, MySQL, SQLite, and SQL Server databases, featuring read-only mode, query validation, SSH tunneling, and field redaction for production-safe data access.
    3
    MIT