@kineticist/mcp-server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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-serverCreate an API key at https://www.kineticist.com/settings.
Related MCP server: opencritic-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
Tool | Description |
| Search and filter games with natural language |
| Full game info with editions, images, and description |
| Design team for a game |
| Game files grouped by machine, optional machine filter |
| Random game for discovery |
| Database statistics |
| Venues near a postal code or city, optionally only those with a given game |
| Search games, news, places to play, people, manufacturers, mods, Hype Index entries and creators |
| Read any Kineticist page by its link; news as headline, summary and link |
| Latest news, new videos and podcasts from creators, and Hype Index moves |
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.
Tool | Description |
| Read your state for a game: ownership, wishlist, plays, fun score, favorite |
| Log a play with optional date, location, note, score, replay flag |
| Mark as owned or no longer owned |
| Toggle want-to-play or want-to-own |
| Set your fun score (0–100) |
| Remove the most recent play for a game |
| Edit a logged play |
| Delete a logged play |
| Add or remove a game from your favorites, or follow or unfollow a creator (by |
| Remove your fun score |
| Edit ownership details for a game you own |
| Write or update your review of a game |
| Delete your review |
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.
Tier | Burst (per second) | Per minute | Per day |
| 10 | 60 | 1,000 |
| 20 | 120 | 5,000 |
| 30 | 200 | 25,000 |
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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
The media memory layer for AI agents and their humans. Your AI client can search your collection, add and log what you've finished, update ratings and lists, and find patterns across everything you've read, watched, played, and listened to.
Steam games, Dev.to articles, events and podcasts as agent tools.
Web search and page reading for AI agents, including JSON APIs, RSS feeds and YouTube.
AgentReady Tools is a searchable catalog of more than 250 APIs, MCP servers and developer tools that AI agents can use, each with agent-readiness checks (docs, auth, OpenAPI, MCP support). Search by task, get tool details and related tools, and read or share field notes from other agents in the Agent Community. Remote MCP endpoint: https://agentready-tools.com/mcp
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to list, read, and fetch gaming news feeds from curated sources or any RSS/Atom feed URL.89 npmMIT
- AlicenseAqualityDmaintenanceEnables AI assistants to search for games and retrieve aggregated critic scores, review tiers, and individual reviews from OpenCritic. Provides tools for game search, score retrieval, and review lookup via the OpenCritic API.39 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to search and retrieve video game information from the IGDB catalog, including games, platforms, companies, release dates, ratings, and cover art.85 npm2MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to search a video game database by name, genre, or platform, retrieve detailed game records, and list genres/platforms with game counts. It exposes these capabilities as MCP tools for ratings, Metacritic scores, release dates, developers, publishers, ESRB ratings, and playtime.87 npmMIT