Skip to main content
Glama
FastStats for Claude
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

Tool Schema Changelog

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

    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
      B
      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
      B
      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.
      4
      MIT