{"openapi":"3.1.0","info":{"title":"Gameshow API","version":"0.1.0","description":"A fully local, hand-curated TV game-show FORMAT reference: 12 generic format archetypes (trivia, wheel-spin guessing, word-puzzle reveal, price guessing, physical challenge, dating/matchmaking, survey guessing, talent judging, hidden-identity/bluffing, risk-ladder press-your-luck, social-strategy elimination, and skill-craft timed challenge), each described generically with real shows referenced only as brief factual examples. Includes a hosting glossary, home-party hosting tips, generic scoring/judging approaches, a group-size/energy-level recommender, and a beginner-host tip list.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://gameshow.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/gameshow/docs"},"termsOfService":"https://connectorbay.com/gameshow/terms"},"servers":[{"url":"https://gameshow.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/gameshow/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/format_archetype_info":{"post":{"operationId":"format_archetype_info","summary":"Full detail on one generic TV game-show format archetype: how the mechanic generically works, its typical","description":"Full detail on one generic TV game-show format archetype: how the mechanic generically works, its typical\n    structure, energy level, ideal group size, what makes it fun, and common hosting pitfalls. Omit the name to\n    list every archetype with a one-line summary. This describes the abstract mechanic, not any one specific\n    show's proprietary rules -- use real_show_example for factual real-show examples. Use for \"how does a\n    wheel-spin format work\", \"what's a hidden-identity format\", \"list every game-show format you cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A format archetype's name, alias, or a short description of the mechanic; omit to list every archetype.","examples":["trivia format","wheel-spinning format","hidden identity","price guessing"],"title":"Name"}},"title":"format_archetype_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/real_show_example":{"post":{"operationId":"real_show_example","summary":"Brief, factual one-line examples of real TV shows that exemplify a given format archetype (e.g. \"the","description":"Brief, factual one-line examples of real TV shows that exemplify a given format archetype (e.g. \"the\n    wheel-spinning format is exemplified by shows like Wheel of Fortune\"). Names real shows factually; never\n    reproduces their actual proprietary game mechanics or round structures as this connector's own content. Use\n    for \"what shows are like Wheel of Fortune\", \"give me real examples of the survey-guessing format\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"archetype":{"description":"A format archetype's name or alias.","examples":["wheel-spinning format","trivia format","dating format"],"minLength":1,"title":"Archetype","type":"string"}},"required":["archetype"],"title":"real_show_exampleArguments","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 game-show lingo -- bonus round, lifeline, sudden death, isolation booth, format","description":"Definitions of common game-show lingo -- bonus round, lifeline, sudden death, isolation booth, format\n    bible, buzzer, showcase, jackpot, wildcard, elimination, panel, emcee, walk-away point, steal, twist, and\n    more. Use for \"what's an isolation booth\", \"what does 'sudden death' mean in a game show\", \"what's a\n    showcase round\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific 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/host_your_own_tip":{"post":{"operationId":"host_your_own_tip","summary":"Practical, generic advice for designing and running a home party version of a game-show-style game --","description":"Practical, generic advice for designing and running a home party version of a game-show-style game --\n    picking a format for your group, writing your own questions, building a DIY spinning wheel, buzzer\n    alternatives, scorekeeping, assigning host/judge roles, pacing the night, prizes and stakes, team formation,\n    adapting for kids or mixed ages, physical safety for challenge or craft rounds, space setup, keeping energy\n    up, handling a tie, and running a version over video call. Omit the topic to list them all. Use for \"how do I\n    run a game-show night for my family\", \"how do I make a spinning wheel at home\", \"what should I use as a\n    buzzer\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A home-hosting topic; omit to list every tip.","examples":["picking a format","building a DIY wheel","buzzer alternatives","physical safety"],"title":"Topic"}},"title":"host_your_own_tipArguments","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/judging_scoring_generic":{"post":{"operationId":"judging_scoring_generic","summary":"Explains a generic judging or scoring approach usable in any home game-show format: point-tally scoring,","description":"Explains a generic judging or scoring approach usable in any home game-show format: point-tally scoring,\n    elimination scoring, judge-panel scoring, audience-vote scoring, time-based scoring, balancing accuracy vs\n    speed, handicap scoring for mixed skill levels, bonus/multiplier scoring, consensus vs strict-criteria\n    judging, and tiebreaker methods. Omit the topic to list them all. Use for \"how should I score a talent\n    contest at home\", \"how do I handle a tie\", \"what's handicap scoring\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A judging/scoring topic; omit to list every topic.","examples":["point tally scoring","judge panel scoring","handicap scoring","tiebreakers"],"title":"Topic"}},"title":"judging_scoring_genericArguments","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_format_for_group":{"post":{"operationId":"find_format_for_group","summary":"Recommends the best-fitting format archetypes for a given player count and desired energy level","description":"Recommends the best-fitting format archetypes for a given player count and desired energy level\n    (low/medium/high), ranked by how well each archetype's ideal group size and energy level match what you\n    asked for. Always returns at least one suggestion. Use for \"what game show format works for 8 people and a\n    chill vibe\", \"best format for a big loud group of 20\", \"low-energy game for a small family gathering\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"player_count":{"description":"How many people will be playing.","examples":[4,8,20],"maximum":200,"minimum":1,"title":"Player Count","type":"integer"},"energy_level":{"description":"Desired energy level for the night.","examples":["low","medium","high"],"title":"Energy Level","type":"string"}},"required":["player_count","energy_level"],"title":"find_format_for_groupArguments","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 broader category (Knowledge & Wit, Luck & Risk, Physical & Endurance, Social & Romance, Performance","description":"Every broader category (Knowledge & Wit, Luck & Risk, Physical & Endurance, Social & Romance, Performance\n    & Judging, Deduction & Strategy) with how many format archetypes fall under it and which ones. Use for \"what\n    categories of game show formats do you cover\", \"what falls under Luck & Risk\".","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 ranked shortlist of the most useful, practical tips for someone hosting their first home game-show","description":"A ranked shortlist of the most useful, practical tips for someone hosting their first home game-show\n    night, from most to least essential. Use for \"tips for hosting my first game-show party\", \"what should I\n    know before running a game night for the first time\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"count":{"default":5,"description":"How many tips to return.","maximum":12,"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}}}}