{
  "schemaVersion": "2026-04",
  "name": "Kineticist",
  "description": "Pinball industry database, hype tracker, and editorial publication. 1,700+ pinball machines, 8,300+ locations, 347 hype themes, 600+ articles.",
  "homepage": "https://www.kineticist.com",
  "contact": {
    "email": "colin@kineticist.com",
    "url": "https://www.kineticist.com/contact"
  },
  "documentation": {
    "human": "https://www.kineticist.com/docs/api",
    "reference": "https://www.kineticist.com/docs/api/reference",
    "openapi": "https://www.kineticist.com/openapi.json",
    "llmsTxt": "https://www.kineticist.com/llms.txt"
  },
  "api": {
    "baseUrl": "https://www.kineticist.com/api/v1",
    "protocol": "REST",
    "auth": {
      "type": "bearer",
      "header": "Authorization: Bearer <key>",
      "signup": "https://www.kineticist.com/settings"
    },
    "rateLimits": {
      "model": "per-key, 3 tiers, enforced as burst + per-minute + per-day",
      "tiers": [
        { "name": "free", "burst": "10/s", "perMinute": 60, "perDay": 1000 },
        { "name": "builder", "burst": "20/s", "perMinute": 120, "perDay": 5000 },
        { "name": "partner", "burst": "30/s", "perMinute": 200, "perDay": 25000 }
      ],
      "notes": "All tiers are free during early access. New keys start on free. Email colin@kineticist.com for a higher ceiling."
    },
    "capabilities": ["read", "write"],
    "resources": [
      "games",
      "game-files",
      "stats",
      "user-library (plays, ownership, wishlist, fun scores)"
    ]
  },
  "packages": {
    "cli": {
      "name": "@kineticist/cli",
      "command": "pinball",
      "registry": "https://www.npmjs.com/package/@kineticist/cli",
      "install": "npm install -g @kineticist/cli"
    },
    "mcpServer": {
      "name": "@kineticist/mcp-server",
      "command": "kineticist-mcp",
      "registry": "https://www.npmjs.com/package/@kineticist/mcp-server",
      "install": "npx @kineticist/mcp-server",
      "transport": "stdio",
      "clients": ["Claude Desktop", "Cursor", "ChatGPT", "any MCP-compatible client"]
    }
  },
  "allowed": {
    "crawling": true,
    "training": "see /robots.txt and /llms.txt"
  }
}