{"openapi":"3.1.0","info":{"title":"Pixelage API","version":"0.1.0","description":"A fully local, hand-curated video game industry history reference: landmark milestones (the 1983 crash, the golden age of arcades, the mid-90s shift to 3D, the mobile boom, the indie renaissance, the rise of live-service/GaaS), console-war eras, a decade-by-decade timeline, a year lookup, an industry term glossary, and the arcade-to-live-service business-model chain.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://pixelage.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/pixelage/docs"},"termsOfService":"https://connectorbay.com/pixelage/terms"},"servers":[{"url":"https://pixelage.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/pixelage/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/milestone_info":{"post":{"operationId":"milestone_info","summary":"Full detail for one landmark industry milestone: year, era, category, a summary, why it mattered, and a","description":"Full detail for one landmark industry milestone: year, era, category, a summary, why it mattered, and a\n    confidence/hedge note when exact figures or 'firsts' are genuinely disputed among historians. Use for \"what\n    caused the 1983 crash\", \"why did the N64 use cartridges\", \"what was Fortnite's battle pass about\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A milestone's name or alias.","examples":["1983 crash","Space Invaders","Fortnite battle royale","PlayStation launch","Minecraft"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"milestone_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/era_overview":{"post":{"operationId":"era_overview","summary":"A named industry era's full narrative -- roughly when it ran, what drove it, and its key developments --","description":"A named industry era's full narrative -- roughly when it ran, what drove it, and its key developments --\n    plus every landmark milestone tied to it in chronological order. Use category_list to see every era name. Use\n    for \"what was the golden age of arcades\", \"what happened during the console wars\", \"explain the shift to 3D\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"era_name":{"description":"An era's name or alias.","examples":["golden age of arcades","1983 crash","console wars","shift to 3D","mobile boom","indie renaissance","live service era"],"minLength":1,"title":"Era Name","type":"string"}},"required":["era_name"],"title":"era_overviewArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/timeline_by_decade":{"post":{"operationId":"timeline_by_decade","summary":"Every landmark milestone touching a given decade (1950s through 2020s), in chronological order. A","description":"Every landmark milestone touching a given decade (1950s through 2020s), in chronological order. A\n    milestone that spans into the decade (like the 1983-1985 crash) is included even if it started earlier. Use\n    for \"what happened in gaming in the 80s\", \"give me a 2010s gaming timeline\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"decade":{"description":"A decade, in almost any common form.","examples":["1980s","the 90s","2000s","2010s"],"minLength":1,"title":"Decade","type":"string"}},"required":["decade"],"title":"timeline_by_decadeArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/term_glossary":{"post":{"operationId":"term_glossary","summary":"Definitions of common video game industry/business terms -- shovelware, AAA, indie, early access, digital","description":"Definitions of common video game industry/business terms -- shovelware, AAA, indie, early access, digital\n    distribution, free-to-play, loot box, battle pass, live service/GaaS, crunch, platform exclusive, and more.\n    Use for \"what's a battle pass\", \"what does AAA mean\", \"what's the difference between a remaster and a\n    remake\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific industry term to look up; omit to list all.","title":"Term"}},"title":"term_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/find_milestone_by_year":{"post":{"operationId":"find_milestone_by_year","summary":"Every landmark milestone that happened in (or, for multi-year events like the 1983 crash, spanned across)","description":"Every landmark milestone that happened in (or, for multi-year events like the 1983 crash, spanned across)\n    a specific calendar year. Use for \"what happened in gaming in 1994\", \"what year did the crash happen\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"year":{"description":"A calendar year.","examples":[1972,1983,1996,2008,2017],"maximum":2100,"minimum":1900,"title":"Year","type":"integer"}},"required":["year"],"title":"find_milestone_by_yearArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/business_model_evolution":{"post":{"operationId":"business_model_evolution","summary":"How the industry has sold games over time, described factually stage by stage: arcade pay-per-play,","description":"How the industry has sold games over time, described factually stage by stage: arcade pay-per-play,\n    cartridge sales, disc sales, digital distribution, free-to-play/microtransactions, subscription services, and\n    live-service/GaaS. Pass a stage name for its full detail (how it worked, why it emerged, how it evolved, its\n    legacy), or omit / pass \"overview\" for the whole chain in order. Use for \"how did games go from arcade\n    quarters to live service\", \"what came before free-to-play\", \"explain the battle pass business model\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A business-model stage to look up; omit or use 'overview' to see the full chain in order.","examples":["arcade quarters","cartridge sales","disc sales","digital distribution","free to play","subscriptions","live service","overview"],"title":"Topic"}},"title":"business_model_evolutionArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/category_list":{"post":{"operationId":"category_list","summary":"Every industry-history era covered, with how many landmark milestones are tied to each one. Use era_overview","description":"Every industry-history era covered, with how many landmark milestones are tied to each one. Use era_overview\n    for a specific era's full narrative. Use for \"what eras of gaming history do you cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"category_listArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/beginner_tips":{"post":{"operationId":"beginner_tips","summary":"A curated shortlist of things worth keeping in mind when learning game industry history -- loose era","description":"A curated shortlist of things worth keeping in mind when learning game industry history -- loose era\n    boundaries, regional differences (the 1983 crash was mostly North American), disputed 'firsts', and gradual\n    rather than sudden business-model shifts. Use for \"what should I know before reading about gaming history\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"count":{"default":5,"description":"How many tips to return.","maximum":10,"minimum":1,"title":"Count","type":"integer"}},"title":"beginner_tipsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}