plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "kineticist",
  "version": "1.0.0",
  "description": "Pinball news and the Kineticist game database in ChatGPT: news, machines and editions, design credits, places to play, manufacturers and the Hype Index.",
  "author": {
    "name": "Kineticist",
    "email": "contact@kineticist.com",
    "url": "https://www.kineticist.com"
  },
  "homepage": "https://www.kineticist.com/mcp",
  "license": "MIT",
  "keywords": [
    "pinball",
    "news",
    "games",
    "arcade",
    "where to play"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Kineticist",
        "shortDescription": "Pinball news and game database",
        "longDescription": "Kineticist is a pinball publication and database. Connect it and ChatGPT can answer pinball questions from Kineticist instead of guessing:\n\n- This week's pinball news, new videos and podcasts from the creators Kineticist follows, and what's climbing the Hype Index of pinball themes.\n- Any pinball machine: editions (Pro, Premium, LE) with prices and production runs, whether it's still made, remakes and remasters, manuals and schematics.\n- Who designed a game: designers, artists, programmers and the rest of the team.\n- Where to play: venues near a postal code or city, or venues that have a particular machine.\n- Manufacturers, people, mods and anything else on kineticist.com, with links back to the pages.\n\nAnswers link to kineticist.com so you can read more. It reads public Kineticist data only and needs no account. Limits: machine lists at venues come from Pinball Map and can lag; a game announced in the last few days may not have its editions in the database yet.",
        "developerName": "Kineticist",
        "category": "Entertainment",
        "capabilities": [
          "Read"
        ],
        "websiteURL": "https://www.kineticist.com",
        "supportURL": "https://www.kineticist.com/contact",
        "privacyPolicyURL": "https://www.kineticist.com/legal/privacy",
        "termsOfServiceURL": "https://www.kineticist.com/legal/terms",
        "defaultPrompt": [
          "What's new in pinball this week?",
          "Who was on the design team for Medieval Madness?",
          "Where can I play pinball in Chicago?"
        ],
        "brandColor": "#F15BB5",
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/logo.png"
      },
      "review": {
        "demo_recording_url": "https://media.kineticist.com/plugins/chatgpt/kineticist-chatgpt-demo-2026-10-19.mp4",
        "test_cases": {
          "positive": [
            {
              "description": "Recent pinball news comes from Kineticist, with article links.",
              "prompt": "What's new in pinball this week?",
              "tools_triggered": "whats_new",
              "expected_behavior": "Lists this week's Kineticist news headlines with links to www.kineticist.com/news/..., and may mention new creator videos and Hype Index moves."
            },
            {
              "description": "A game's design team.",
              "prompt": "Who was on the design team for Medieval Madness?",
              "tools_triggered": "get_game_credits",
              "expected_behavior": "Names Brian Eddy as the designer, with the rest of the credited team, and links the game page on kineticist.com."
            },
            {
              "description": "A machine's editions and their list prices.",
              "prompt": "What editions of Godzilla pinball are there, and what did each cost?",
              "tools_triggered": "get_game_details",
              "expected_behavior": "Lists the Godzilla (Stern, 2021) editions with their list prices, including the Premium at $8,999, and links the game page."
            },
            {
              "description": "Filtering the catalog by manufacturer and production status.",
              "prompt": "Which Stern pinball machines are still in production?",
              "tools_triggered": "search_pinball_games",
              "expected_behavior": "Lists current Stern Pinball games (such as Fallout, Pok\u00e9mon and AC/DC Remastered) with links to their kineticist.com pages."
            },
            {
              "description": "Venues near a place that have a specific machine.",
              "prompt": "Where can I play Godzilla near 97214?",
              "tools_triggered": "where_to_play",
              "expected_behavior": "Lists venues near Portland, OR (97214) that have Godzilla, nearest first, with distances and links to each venue's kineticist.com page."
            }
          ],
          "negative": [
            {
              "description": "Not a pinball question: the plugin should not be called; ChatGPT answers on its own.",
              "prompt": "What's the weather in Chicago tomorrow?"
            },
            {
              "description": "General writing request unrelated to pinball data: no Kineticist tool should run.",
              "prompt": "Write a short poem about the ocean."
            },
            {
              "description": "A request to change account data: the plugin is read-only, so it should not attempt a write; ChatGPT should explain it can look things up but can't rate games or edit lists.",
              "prompt": "Rate Godzilla 90 out of 100 on my Kineticist account."
            }
          ]
        }
      },
      "publication": {
        "countries": [],
        "release_notes": "1.0.0: first release of Kineticist in ChatGPT. It connects ChatGPT to Kineticist's public, read-only MCP server at https://www.kineticist.com/api/mcp, with no account or API key. Ten tools: whats_new (recent news, creator videos and podcasts, Hype Index moves), search_pinball_games and get_game_details (machines, editions, prices, production status), get_game_credits (design teams), where_to_play (venues near a place, or venues with a given machine), list_game_files (manuals and schematics), get_pinball_stats, get_random_game, and search and get for anything else on kineticist.com. Every answer links back to kineticist.com."
      },
      "apps": "./.app.json"
    }
  }
}