{"id":228314,"name":"Kineticist","description":"Pinball industry database, hype tracker, and editorial publication. 1,700+ pinball machines, 2,800+ notable locations, 347 hype themes, 600+ articles.","card_url":"https://www.kineticist.com/.well-known/agent-card.json","endpoint":"https://www.kineticist.com/api/v1","protocol_version":"1.0","first_seen":"2026-10-19T06:41:50.938612+00:00","last_verified":"2026-10-19T06:41:50.938612+00:00","card":{"api":{"auth":{"type":"bearer","header":"Authorization: Bearer <key>","signup":"https://www.kineticist.com/settings"},"baseUrl":"https://www.kineticist.com/api/v1","protocol":"REST","resources":["games","machines (individual physical machines — the addressable unit beneath a game; Pro/Premium/LE editions AND chassis siblings)","game-files","stats","user-library (plays, ownership, wishlist, fun scores)"],"rateLimits":{"model":"per-account (all of an account's keys share one budget), 3 tiers, enforced as burst + per-minute + per-day","notes":"All tiers are free during early access. New keys start on free. Email colin@kineticist.com for a higher ceiling.","tiers":[{"name":"free","burst":"10/s","perDay":1000,"perMinute":60},{"name":"builder","burst":"20/s","perDay":5000,"perMinute":120},{"name":"partner","burst":"30/s","perDay":25000,"perMinute":200}]},"capabilities":["read","write"]},"url":"https://www.kineticist.com","name":"Kineticist","skills":[{"id":"search_pinball_games","name":"Search Pinball Games","tags":["search","games","pinball","database","filter","browse"],"examples":["Find all Stern games from 2023","What pinball games have dinosaurs?","Show me the highest-rated games in production"],"description":"Search and filter the Kineticist pinball game database. Supports text search, manufacturer filtering, year ranges, production status, and sorting. Returns game names, slugs, manufacturers, fun scores, and edition counts."},{"id":"get_game_details","name":"Get Game Details","tags":["games","pinball","details","editions","pricing"],"examples":["Tell me about Godzilla pinball","What editions does Jurassic Park come in?","Show me the rules for Medieval Madness"],"description":"Get full details for a pinball game including editions (Pro/Premium/LE with pricing), images, tags, description, and rules links."},{"id":"where_to_play","name":"Find Where to Play","tags":["locations","where-to-play","near-me","venues","pinball"],"examples":["Where can I play pinball in Chicago?","Where can I play Godzilla near 97214?","Pinball bars near Portland, OR"],"description":"Find pinball venues near a postal code or city, optionally only those that have a given game. Returns up to 10 listed venues with distance, machine count, venue kind and a kineticist.com page link. HTTP MCP endpoint only (/api/mcp); no key needed."},{"id":"search","name":"Search Kineticist","tags":["search","pinball","news","people","manufacturers","locations"],"examples":["Who is Steve Ritchie?","Find Kineticist articles about Pinburgh","Search for Spooky Pinball"],"description":"Search everything on Kineticist: games, news articles, places to play, manufacturers, people, mods, Hype Index entries and creators. Up to 10 matches with type, title, subtitle and page link. HTTP MCP endpoint only (/api/mcp); no key needed."},{"id":"get","name":"Read a Kineticist Page","tags":["read","page","markdown","pinball"],"examples":["Tell me about this page: https://www.kineticist.com/people/steve-ritchie","What does Kineticist say about Stern Pinball?"],"description":"Read any Kineticist page by its link, as markdown: game, Hype Index entry, place to play, manufacturer, person, mod or creator. News articles come back as headline, date, summary and link. HTTP MCP endpoint only (/api/mcp); no key needed."},{"id":"whats_new","name":"What's New in Pinball","tags":["news","hype-index","latest","pinball"],"examples":["What's new in pinball this week?","What's climbing the Hype Index?"],"description":"The latest Kineticist news (headline, date, summary, link) and the Hype Index top 10 and this week's biggest climbers. HTTP MCP endpoint only (/api/mcp); no key needed."},{"id":"get_random_game","name":"Get Random Game","tags":["games","pinball","random","discovery"],"examples":["Pick a random pinball game for me","Surprise me with a pinball machine"],"description":"Get a random pinball game with full details. Different game every time. Great for discovery, recommendations, or 'game of the day' features."},{"id":"get_pinball_stats","name":"Get Database Stats","tags":["stats","metrics","pinball","database"],"examples":["How many pinball games are in the database?","What's the highest-rated game?"],"description":"Get database statistics: total games, games in production, total manufacturers, total designers, average fun score, most rated game, and newest game."},{"id":"get_game_credits","name":"Get Game Design Team","tags":["games","pinball","credits","design","people"],"examples":["Who designed Godzilla?","Show me the team behind Jurassic Park"],"description":"Get the design team for a pinball game — designer, artist, programmer, mechanical engineer, sound designer, animator, etc. Each credit includes the person plus `role` (slug, stable for filtering), `role_name` (display name from credit_roles.name), and `is_lead` (per-game first-chair boolean)."},{"id":"list_game_files","name":"List Game Files by Machine","tags":["games","pinball","files","machines","manuals"],"examples":["Which files on Firepower are for Fire Action?","List the manuals for Godzilla"],"description":"List a pinball game's manuals, ROMs, schematics and other files grouped by the machine each is for, each with a one-line description, optionally narrowed to one machine. Links to the game page, where a free Kineticist account can download them."},{"id":"kineticist_log_play","name":"Log a Play","tags":["plays","diary","user","tracking","write"],"examples":["Log that I played Godzilla today at Logan Arcade","I played Jurassic Park yesterday and got 500 million"],"description":"Log a play of a pinball game for the authenticated user. Tracks date, location, score, and notes."},{"id":"kineticist_toggle_ownership","name":"Toggle Game Ownership","tags":["ownership","collection","user","write"],"examples":["Add Medieval Madness to my collection","I sold my Jurassic Park"],"description":"Mark a game as owned or no longer owned for the authenticated user. Tracks acquisition and removal details."},{"id":"kineticist_toggle_want","name":"Toggle Want-to-Play / Wishlist","tags":["wishlist","want-to-play","user","write"],"examples":["Add Godzilla to my wishlist","Mark Stranger Things as want-to-play"],"description":"Toggle the authenticated user's want-to-play or want-to-own flag for a game. Calling twice turns the flag off."},{"id":"kineticist_set_fun_score","name":"Set Fun Score","tags":["rating","fun-score","review","user","write"],"examples":["Rate Godzilla 92","I give Medieval Madness a 95 out of 100"],"description":"Set the authenticated user's fun score (1-100) for a game. Upserts — calling again overwrites."},{"id":"kineticist_undo_last_play","name":"Undo Last Play","tags":["plays","undo","user","write"],"examples":["Undo my last Godzilla play","I logged that play by accident, remove it"],"description":"Delete the authenticated user's most recent play log for a game. Errors if there is no play to undo."},{"id":"kineticist_toggle_favorite","name":"Toggle Favorite / Follow","tags":["favorite","follow","creator","user","write"],"examples":["Mark Godzilla as a favorite","Unfavorite Stranger Things for me","Follow Kaneda Says"],"description":"Toggle the authenticated user's favorite (game) or follow (creator). Provide gameId to favorite a game, or promoterId to follow a creator. Calling twice removes it."},{"id":"kineticist_delete_fun_score","name":"Delete Fun Score","tags":["rating","user","write"],"examples":["Remove my rating on Avatar","I changed my mind, clear my Spider-Man score"],"description":"Delete the authenticated user's fun score for a game. The score recorded inside a written review is NOT removed by this — call kineticist_delete_review for that."},{"id":"kineticist_update_play_log","name":"Update Play Log","tags":["plays","edit","user","write"],"examples":["Fix the date on play log abc-123","Add a note to my last Godzilla play"],"description":"Update an existing play log row owned by the authenticated user. Pass any subset of fields; omitted fields are left untouched."},{"id":"kineticist_delete_play_log","name":"Delete Play Log","tags":["plays","delete","user","write"],"examples":["Delete play log abc-123","Remove that bogus play I logged last month"],"description":"Delete an existing play log row owned by the authenticated user (by play log id, not game id)."},{"id":"kineticist_update_ownership_details","name":"Update Ownership Details","tags":["ownership","edit","user","write"],"examples":["Set my Godzilla purchase price to 8000","Pin my James Bond ownership to the LE trim"],"description":"Update purchase price, source, trade detail, trim, or sale price on the user's most-recent open ownership record for a game."},{"id":"kineticist_submit_review","name":"Submit Review","tags":["review","rating","user","write"],"examples":["Rate Godzilla 92 with a quick note about the layout","Save my Cosmic Princess review (88, 'best Sega in years')"],"description":"Save the authenticated user's review (fun score 1-100 + optional written body) for a game. Upserts on (game, user)."},{"id":"kineticist_delete_review","name":"Delete Review","tags":["review","delete","user","write"],"examples":["Delete my Avatar review","Remove my written take on Star Wars"],"description":"Delete the authenticated user's review for a game. The fun score recorded via kineticist_set_fun_score is NOT removed by this."},{"id":"kineticist_get_my_state","name":"Get My Engagement State","tags":["user","state","verification","library"],"examples":["What's my play count for Godzilla?","Have I rated Jurassic Park yet?"],"description":"Get the authenticated user's engagement state for a game: owned, wishlist flags, play count, latest play, fun score, ownership details. Read-only — useful for verifying after a write."}],"allowed":{"crawling":true,"training":"see /robots.txt and /llms.txt"},"contact":{"url":"https://www.kineticist.com/contact","email":"colin@kineticist.com"},"iconUrl":"https://www.kineticist.com/images/kineticist-k-mark.png","version":"1.0.0","homepage":"https://www.kineticist.com","packages":{"cli":{"name":"@kineticist/cli","command":"pinball","install":"npm install -g @kineticist/cli","registry":"https://www.npmjs.com/package/@kineticist/cli"},"mcpServer":{"name":"@kineticist/mcp-server","clients":["Claude Desktop","Cursor","ChatGPT","any MCP-compatible client","in-browser agents (WebMCP)"],"command":"kineticist-mcp","install":"npx @kineticist/mcp-server","httpAuth":"none for the ten read-only tools (search_pinball_games, get_game_details, get_random_game, get_pinball_stats, get_game_credits, list_game_files, where_to_play, search, get, whats_new); bearer (same Kineticist API key as /api/v1/*) for the account tools","registry":"https://www.npmjs.com/package/@kineticist/mcp-server","transports":["stdio","streamable-http","webmcp"],"webmcpNote":"Every public page on www.kineticist.com registers tools via navigator.modelContext (Web Model Context API). Anonymous visitors get the read tools (search_pinball_games, get_game_details, find_locations_near_zip); signed-in visitors additionally get the write tools (log_play, toggle_owned, toggle_wishlist, set_fun_score, undo_last_play). In-page polyfill via @mcp-b/webmcp-polyfill so the API is reachable in browsers that haven't yet shipped native navigator.modelContext.","httpEndpoint":"https://www.kineticist.com/api/mcp","rateLimitNote":"With a key, MCP HTTP requests consume the account's tier limit twice per tools/call — once at the /api/mcp route, once on the tool's internal /api/v1/* fetch. Free tier (1000/day) supports about 500 MCP calls/day.","anonymousLimits":"No-key calls: 60 per minute and 2,000 per day per IP, plus a site-wide daily ceiling. Past a limit the tool answers with a message to try again tomorrow or add a free key."}},"provider":{"url":"https://www.kineticist.com","organization":"Kineticist"},"description":"Pinball industry database, hype tracker, and editorial publication. 1,700+ pinball machines, 2,800+ notable locations, 347 hype themes, 600+ articles.","capabilities":{"streaming":false,"extendedAgentCard":false,"pushNotifications":false},"documentation":{"human":"https://www.kineticist.com/docs/api","llmsTxt":"https://www.kineticist.com/llms.txt","openapi":"https://www.kineticist.com/openapi.json","reference":"https://www.kineticist.com/docs/api/reference","llmsFullTxt":"https://www.kineticist.com/llms-full.txt"},"schemaVersion":"2026-04","documentationUrl":"https://www.kineticist.com/docs/api","defaultInputModes":["application/json"],"contentNegotiation":{"markdown":{"perRoute":{"fallback":"Non-detail-page URLs (browse, homepage, etc.) return the siteOverview.","discovery":"Each detail page declares <link rel=\"alternate\" type=\"text/markdown\" href=\"{canonical}.md\"> in <head>.","acceptHeader":"text/markdown","suffixPattern":"{canonical}.md","tokensEstimate":"1000-3000 per route (vs ~14,000 HTML decoded)","supportedRoutes":[{"example":"/news/worst-video-modes-90s.md","pattern":"/news/[slug]"},{"example":"/games/pinball/godzilla-premium.md","pattern":"/games/pinball/[slug]"},{"example":"/hype/godzilla.md","pattern":"/hype/[slug]"},{"example":"/locations/pinz-portland.md","pattern":"/locations/[slug]"},{"example":"/manufacturers/stern-pinball.md","pattern":"/manufacturers/[slug]"},{"example":"/people/keith-elwin.md","pattern":"/people/[slug]"},{"example":"/mods/cliffy-protectors.md","pattern":"/mods/[slug]"},{"example":"/promoters/replay-fx.md","pattern":"/promoters/[slug]"},{"example":"/events/texas-pinball-festival.md","pattern":"/events/[slug]"},{"example":"/events/texas-pinball-festival/2026.md","pattern":"/events/[series]/[edition]"}]},"directFetch":{"note":"Projections for entities that have NO HTML detail page, so there is no canonical URL to suffix with .md and no rel=alternate link to discover them by. Fetch these paths directly. Listed separately from perRoute on purpose: perRoute entries are alternates of pages, these are not.","routes":[{"example":"/api/markdown/machines/el-dorado-1975-solar-city","pattern":"/api/markdown/machines/{slug}","resource":"machines","canonicalNote":"The document's canonical URL points at the parent GAME page, which is where the website covers this machine."}]},"siteOverview":{"url":"/llms.txt","note":"Curated site overview, ~700 tokens. Returned for any URL via Accept: text/markdown when no per-route projection exists.","accept":"text/markdown"}}},"defaultOutputModes":["application/json"],"supportedInterfaces":[{"url":"https://www.kineticist.com/api/v1","protocolBinding":"HTTP+JSON","protocolVersion":"1.0"},{"url":"https://www.kineticist.com/api/mcp","protocolBinding":"JSONRPC","protocolVersion":"2025-03-26"}]},"signature_status":"unsigned","signature_detail":"No card signature supplied","signature_key_url":null,"signature_checked_at":"2026-10-19T06:41:50.938612+00:00","domain_claimed_at":null,"domain_proof_checked_at":null,"source_name":"Agent Tools Catalog","source_url":"https://agent-tools.cloud","last_check":{"checked_at":"2026-10-19T06:41:50.938612+00:00","success":true,"http_status":200,"detail":"Agent Card validated"},"also_published_at":[],"history_urls":["https://www.kineticist.com/.well-known/agent-card.json"],"also_observed_in":[{"source_name":"Agent Tools Catalog","source_url":"https://agent-tools.cloud","last_seen":"2026-10-19T06:39:03.459022+00:00"}],"skills":[{"skill_id":"kineticist_delete_fun_score","name":"Delete Fun Score","description":"Delete the authenticated user's fun score for a game. The score recorded inside a written review is NOT removed by this — call kineticist_delete_review for that.","tags":["rating","user","write"],"quality_warning":false},{"skill_id":"kineticist_delete_play_log","name":"Delete Play Log","description":"Delete an existing play log row owned by the authenticated user (by play log id, not game id).","tags":["plays","delete","user","write"],"quality_warning":false},{"skill_id":"kineticist_delete_review","name":"Delete Review","description":"Delete the authenticated user's review for a game. The fun score recorded via kineticist_set_fun_score is NOT removed by this.","tags":["review","delete","user","write"],"quality_warning":false},{"skill_id":"where_to_play","name":"Find Where to Play","description":"Find pinball venues near a postal code or city, optionally only those that have a given game. Returns up to 10 listed venues with distance, machine count, venue kind and a kineticist.com page link. HTTP MCP endpoint only (/api/mcp); no key needed.","tags":["locations","where-to-play","near-me","venues","pinball"],"quality_warning":false},{"skill_id":"get_pinball_stats","name":"Get Database Stats","description":"Get database statistics: total games, games in production, total manufacturers, total designers, average fun score, most rated game, and newest game.","tags":["stats","metrics","pinball","database"],"quality_warning":false},{"skill_id":"get_game_credits","name":"Get Game Design Team","description":"Get the design team for a pinball game — designer, artist, programmer, mechanical engineer, sound designer, animator, etc. Each credit includes the person plus `role` (slug, stable for filtering), `role_name` (display name from credit_roles.name), and `is_lead` (per-game first-chair boolean).","tags":["games","pinball","credits","design","people"],"quality_warning":false},{"skill_id":"get_game_details","name":"Get Game Details","description":"Get full details for a pinball game including editions (Pro/Premium/LE with pricing), images, tags, description, and rules links.","tags":["games","pinball","details","editions","pricing"],"quality_warning":false},{"skill_id":"kineticist_get_my_state","name":"Get My Engagement State","description":"Get the authenticated user's engagement state for a game: owned, wishlist flags, play count, latest play, fun score, ownership details. Read-only — useful for verifying after a write.","tags":["user","state","verification","library"],"quality_warning":false},{"skill_id":"get_random_game","name":"Get Random Game","description":"Get a random pinball game with full details. Different game every time. Great for discovery, recommendations, or 'game of the day' features.","tags":["games","pinball","random","discovery"],"quality_warning":false},{"skill_id":"list_game_files","name":"List Game Files by Machine","description":"List a pinball game's manuals, ROMs, schematics and other files grouped by the machine each is for, each with a one-line description, optionally narrowed to one machine. Links to the game page, where a free Kineticist account can download them.","tags":["games","pinball","files","machines","manuals"],"quality_warning":false},{"skill_id":"kineticist_log_play","name":"Log a Play","description":"Log a play of a pinball game for the authenticated user. Tracks date, location, score, and notes.","tags":["plays","diary","user","tracking","write"],"quality_warning":false},{"skill_id":"get","name":"Read a Kineticist Page","description":"Read any Kineticist page by its link, as markdown: game, Hype Index entry, place to play, manufacturer, person, mod or creator. News articles come back as headline, date, summary and link. HTTP MCP endpoint only (/api/mcp); no key needed.","tags":["read","page","markdown","pinball"],"quality_warning":false},{"skill_id":"search","name":"Search Kineticist","description":"Search everything on Kineticist: games, news articles, places to play, manufacturers, people, mods, Hype Index entries and creators. Up to 10 matches with type, title, subtitle and page link. HTTP MCP endpoint only (/api/mcp); no key needed.","tags":["search","pinball","news","people","manufacturers","locations"],"quality_warning":false},{"skill_id":"search_pinball_games","name":"Search Pinball Games","description":"Search and filter the Kineticist pinball game database. Supports text search, manufacturer filtering, year ranges, production status, and sorting. Returns game names, slugs, manufacturers, fun scores, and edition counts.","tags":["search","games","pinball","database","filter","browse"],"quality_warning":false},{"skill_id":"kineticist_set_fun_score","name":"Set Fun Score","description":"Set the authenticated user's fun score (1-100) for a game. Upserts — calling again overwrites.","tags":["rating","fun-score","review","user","write"],"quality_warning":false},{"skill_id":"kineticist_submit_review","name":"Submit Review","description":"Save the authenticated user's review (fun score 1-100 + optional written body) for a game. Upserts on (game, user).","tags":["review","rating","user","write"],"quality_warning":false},{"skill_id":"kineticist_toggle_favorite","name":"Toggle Favorite / Follow","description":"Toggle the authenticated user's favorite (game) or follow (creator). Provide gameId to favorite a game, or promoterId to follow a creator. Calling twice removes it.","tags":["favorite","follow","creator","user","write"],"quality_warning":false},{"skill_id":"kineticist_toggle_ownership","name":"Toggle Game Ownership","description":"Mark a game as owned or no longer owned for the authenticated user. Tracks acquisition and removal details.","tags":["ownership","collection","user","write"],"quality_warning":false},{"skill_id":"kineticist_toggle_want","name":"Toggle Want-to-Play / Wishlist","description":"Toggle the authenticated user's want-to-play or want-to-own flag for a game. Calling twice turns the flag off.","tags":["wishlist","want-to-play","user","write"],"quality_warning":false},{"skill_id":"kineticist_undo_last_play","name":"Undo Last Play","description":"Delete the authenticated user's most recent play log for a game. Errors if there is no play to undo.","tags":["plays","undo","user","write"],"quality_warning":false},{"skill_id":"kineticist_update_ownership_details","name":"Update Ownership Details","description":"Update purchase price, source, trade detail, trim, or sale price on the user's most-recent open ownership record for a game.","tags":["ownership","edit","user","write"],"quality_warning":false},{"skill_id":"kineticist_update_play_log","name":"Update Play Log","description":"Update an existing play log row owned by the authenticated user. Pass any subset of fields; omitted fields are left untouched.","tags":["plays","edit","user","write"],"quality_warning":false},{"skill_id":"whats_new","name":"What's New in Pinball","description":"The latest Kineticist news (headline, date, summary, link) and the Hype Index top 10 and this week's biggest climbers. HTTP MCP endpoint only (/api/mcp); no key needed.","tags":["news","hype-index","latest","pinball"],"quality_warning":false}],"quality_flags":[],"check_history":{"checks":1,"passed":1},"recent_checks":[{"card_url":"https://www.kineticist.com/.well-known/agent-card.json","checked_at":"2026-10-19T06:41:50.938612+00:00","success":true,"http_status":200,"detail":"Agent Card validated"}],"endpoint_tls_check":null,"protocol_check":{"checked_at":"2026-10-19T06:41:50.938612+00:00","state":"unconfirmed","http_status":404,"detail":"Protocol response exceeded 16 KiB limit"},"x402_price_check":null,"events":[],"relationships":[],"verification":{"agent_card_url":"https://www.kineticist.com/.well-known/agent-card.json","last_successful_card_check":"2026-10-19T06:41:50.938612+00:00","latest_card_check":{"checked_at":"2026-10-19T06:41:50.938612+00:00","success":true,"http_status":200,"detail":"Agent Card validated"},"signature_status":"unsigned","signature_checked_at":"2026-10-19T06:41:50.938612+00:00","task_endpoint_tested":true,"task_execution_tested":false,"endpoint_tls_checked_at":null,"endpoint_tls_reachable":null,"protocol_check_state":"unconfirmed","protocol_checked_at":"2026-10-19T06:41:50.938612+00:00","provider_identity_verified":false,"domain_claimed_at":null,"domain_proof_checked_at":null}}