Kineticist

Find pinball machines: "what pinball games has Stern made?", "which machines are in production?", "pinball games from 1992". Searches and filters the Kineticist pinball game database. Supports text search, manufacturer filtering, year ranges, production status, and sorting. Returns game names, slugs, manufacturers, fun scores, edition counts, and each game's page URL on kineticist.com (link it when citing a game).

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Text search by game name (fuzzy, 2+ chars). Natural language works — 'that stern game with dinosaurs' will find Godzilla.",
      "type": "string"
    },
    "manufacturer": {
      "description": "Filter by manufacturer name or slug (fuzzy match — 'stern' works)",
      "type": "string"
    },
    "in_production": {
      "description": "Filter to only games currently in production (true) or out of production (false)",
      "type": "boolean"
    },
    "year_from": {
      "description": "Minimum manufacture year",
      "type": "number"
    },
    "year_to": {
      "description": "Maximum manufacture year",
      "type": "number"
    },
    "sort": {
      "description": "Sort field. Prefix with - for descending. Options: name, first_manufacture_year, average_fun_score, ratings_count",
      "type": "string"
    },
    "limit": {
      "description": "Results per page (1-100, default 25)",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Tell me about a pinball machine: "what is Godzilla pinball?", "how much is the Jurassic Park Premium?", "is Medieval Madness still made?". Full details for one game including editions (Pro/Premium/LE with pricing), images, tags, description, and rules links. `url` is the game's page on kineticist.com (link it when citing); remakes carry their own `url`. Editions that belong to a remake are listed under that remake. `best_image` (when present) is the one picture to show for the game: its URL, what it shows (backglass, photo, cabinet, flyer or playfield) and its size. Accepts slug (godzilla-2021), OPDB group ID (weeP), or OPDB machine ID (GweeP-MW95j). Use ?include=credits to also get the design team.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Game slug, OPDB ID, or Kineticist game ID"
    },
    "include_credits": {
      "description": "Include design team credits (designer, artist, programmer, etc.)",
      "type": "boolean"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Suggest a pinball machine: "surprise me", "pinball game of the day". A random pinball game with full details, including `best_image` (the one picture to show) when there is one. Different game every time. Great for discovery, recommendations, or 'game of the day' features.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

How big is the pinball world: "how many pinball machines are in production?", "how many pinball manufacturers are there?". Kineticist database statistics: total games, games in production, total manufacturers, total designers, average fun score, most rated game, and newest game.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Who made a pinball machine: "who designed Attack from Mars?", "who did the art for Twilight Zone?". The design team for a pinball game — designer, artist, programmer, mechanical engineer, sound designer, animator, etc. Each credit includes the person's name and role. Every row carries `role` (slug, e.g. "design"), `role_name` (display name, e.g. "Design"), and, only where several people share a role on the game, `is_lead: true` on the first chair (no is_lead means no ranking, not "not the lead"). Read `role_name` for human display; `role` is the stable slug for filtering. Each person carries `url`, their page on kineticist.com, and `game_url` is the game's page (link them when citing).

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Game slug or ID"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find a pinball manual or schematic: "where's the Firepower manual?", "schematics for Fish Tales". Lists a pinball game's downloadable files (manuals, ROMs, schematics, parts lists, bulletins) grouped by the machine each file is for. Each file line ends with a one-line description of what sets it apart (edition, print, language, format) when the title alone doesn't say. Use it to answer 'which file is for which machine' — e.g. Firepower's page also carries Taito's Fire Action files, and this tool tells them apart. Pass `machine` (trm_ id, slug, UUID or OPDB machine id) to narrow to one machine. Lists metadata only and ends with the game page's Documentation link; downloading a file needs a free Kineticist account, so send readers to that page to sign in and download.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Game slug or ID"
    },
    "machine": {
      "description": "Optional machine filter: trm_ id, slug, UUID or OPDB machine id",
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Where to play pinball: "where can I play pinball in Chicago?", "where can I play Godzilla near 97214?", "pinball bars in Portland". Finds pinball venues near a place: a postal code ("60601", "SW1A 1AA" with country gb) or a city ("Chicago", "Portland, OR"). Pass `game` (name or slug) to find venues that have that machine. Returns up to 10 venues, nearest first, with city, distance in miles, machine count, venue kind (bar, arcade…) and `url`, the venue's page on kineticist.com (link it; it has the address and full machine list). `searched` says which place was used; `note` says when these are the nearest anywhere rather than nearby. Machine lists come from Pinball Map and can lag.

{
  "type": "object",
  "properties": {
    "place": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "Postal code or city, e.g. \"60601\", \"Chicago\", \"Portland, OR\""
    },
    "country": {
      "description": "Two-letter country code for postal codes outside the US (gb, ca, de…). Default us.",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "game": {
      "description": "Only venues that have this game: a name (\"Godzilla\") or slug (godzilla-2021)",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    }
  },
  "required": [
    "place"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Look up anything pinball on Kineticist: "who is Steve Ritchie?", "tell me about Spooky Pinball", "Kineticist articles about Pinburgh". Searches everything on Kineticist: games, news articles, places to play, manufacturers, people, mods, Hype Index entries and creators. Returns up to 10 matches, best first, each with its type, title, a short subtitle and `url` (its page on kineticist.com). Pass `type` to look in one kind only. For game details use get_game_details; for any other result, pass its url to `get`.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "What to look for, e.g. \"Steve Ritchie\", \"Stern\", \"Pinburgh\""
    },
    "type": {
      "description": "Only this kind of result",
      "type": "string",
      "enum": [
        "game",
        "article",
        "location",
        "manufacturer",
        "person",
        "mod",
        "hype",
        "promoter"
      ]
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Read what Kineticist says about something: "what does Kineticist say about Logan Arcade?", or any www.kineticist.com link. Reads a Kineticist page by its link, as markdown: a game, Hype Index entry, place to play, manufacturer, person, mod or creator. News articles come back as headline, date, summary and link only; send readers to the link for the full article. Use the `url` from search or another tool.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "description": "A www.kineticist.com page link, e.g. https://www.kineticist.com/people/steve-ritchie"
    }
  },
  "required": [
    "url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

What's new in pinball: "what's new in pinball this week?", "latest pinball news", "what's climbing the Hype Index?". The latest Kineticist news articles (headline, date, summary and link; `members_section` means part of the article is for members; `games` lists the machines an article covers, so call get_game_details with a game's slug for its editions, prices and design team rather than searching the web; a release announced in the last few days may not have its new editions in the database yet, so check the edition dates against the article before quoting prices), new videos, podcasts and posts from the pinball creators Kineticist follows (`from_creators`: title, creator, format, date, summary, link), and Kineticist's Hype Index ranking (the current top 10 and this week's biggest climbers). This covers the week in pinball; link the articles and creator items rather than retelling them.

{
  "type": "object",
  "properties": {
    "days": {
      "description": "How far back to look for news, in days (default 7)",
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}