Read-only mirror of the Kineticist MCP server. Changes are made in the Kineticist repo; issues and questions go to contact@kineticist.com.

@kineticist/mcp-server

Model Context Protocol server for the Kineticist pinball game database. Lets AI agents like Claude, Cursor, and ChatGPT search the catalog, read game details, and act on your own library: log plays, toggle ownership and wishlist, set fun scores, write reviews.

Just want to read Kineticist? You don't need this package or a key. Add the hosted server, https://www.kineticist.com/api/mcp, to your app. In Claude, it's in the connector directory: https://claude.ai/directory/kineticist. Setup for ChatGPT, Cursor and Codex: https://www.kineticist.com/mcp.

This package runs locally and needs a Kineticist API key. It has every tool the hosted server has, plus tools that change your own library.

Install

Claude Desktop

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "kineticist": {
      "command": "npx",
      "args": ["@kineticist/mcp-server"],
      "env": {
        "KINETICIST_API_KEY": "ki_live_..."
      }
    }
  }
}

Cursor

Edit .cursor/mcp.json in your project (same shape as above).

Claude Code

claude mcp add kineticist \
  --env KINETICIST_API_KEY=ki_live_... \
  -- npx @kineticist/mcp-server

Create an API key at https://www.kineticist.com/settings.

Related MCP server: skillsindex-mcp

Tools

The server exposes 23 tools: 10 for reading Kineticist and 13 for acting on the key owner's own library. All of them call Kineticist's REST API with your key.

Read tools

Read tools return each game's and person's page on www.kineticist.com, so answers can link back. Files download from the game page with a free Kineticist account. Every tool carries a title and MCP annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint).

Your library tools

Wrap POST /api/v1/me/actions and GET /api/v1/me/state. All act on the data belonging to the API key owner.

Example conversations

Once the server is configured, your agent can answer things like:

• "What Stern games are currently in production?"

• "Who designed Medieval Madness?"

• "Give me a random pinball machine I've never heard of."

• "Log that I played Godzilla at Pin Museum last night and give it an 87."

• "What's my state on The Addams Family?"

• "Undo my last play of Stranger Things."

Tiers

Every account has one of three tiers, and its limits are shared by all of the account's keys (a second key doesn't add quota). All tiers are free during early access; the tier just sets the ceiling.

New accounts start on free. Agents that make dozens of calls per task burn through a free account quickly. Email colin@kineticist.com with a short note about what you're building if you need a higher ceiling.

Full reference

• Web docs: https://www.kineticist.com/docs/api

• Interactive REST reference: https://www.kineticist.com/docs/api/reference

• OpenAPI spec: https://www.kineticist.com/openapi.json

• CLI: @kineticist/cli

License

MIT