{"openapi":"3.1.0","info":{"title":"Quizmaster API","version":"0.1.0","description":"A fully local, hand-curated trivia-night hosting and format reference: round formats, question-writing technique, scoring systems, tiebreaker methods, a themed category-idea generator, a round-structure planner, a hosting glossary and beginner-host tips. A hosting/format guide, not a trivia question database.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://quizmaster.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/quizmaster/docs"},"termsOfService":"https://connectorbay.com/quizmaster/terms"},"servers":[{"url":"https://quizmaster.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/quizmaster/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_info":{"post":{"operationId":"format_info","summary":"Full detail on one trivia round format: how it works, what it's best for, pros/cons, and hosting tips.","description":"Full detail on one trivia round format: how it works, what it's best for, pros/cons, and hosting tips.\n    Omit the name to list every format with a one-line summary. Use for \"how does a wager round work\", \"what's\n    a lightning round\", \"list every round format you know\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A round format's name or alias; omit to list every format.","examples":["picture round","wager round","lightning round"],"title":"Name"}},"title":"format_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/question_writing_tip":{"post":{"operationId":"question_writing_tip","summary":"Actionable technique for writing better trivia questions: difficulty calibration, avoiding ambiguity,","description":"Actionable technique for writing better trivia questions: difficulty calibration, avoiding ambiguity,\n    avoiding overly obscure trivia, clear wording, multiple-choice distractor design, avoiding regional bias or\n    stale facts, fact-checking, avoiding double negatives, category balance, pacing, avoiding giveaways, and\n    handling sensitive topics. Omit the topic to list them all. Use for \"how do I calibrate trivia difficulty\",\n    \"how do I avoid ambiguous questions\", \"tips for writing multiple choice options\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A question-writing topic; omit to list every tip.","examples":["difficulty calibration","avoiding ambiguity","avoiding overly-obscure trivia"],"title":"Topic"}},"title":"question_writing_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/scoring_system":{"post":{"operationId":"scoring_system","summary":"Explains one trivia scoring system: how it works, pros/cons, and what kind of night it suits. Omit the","description":"Explains one trivia scoring system: how it works, pros/cons, and what kind of night it suits. Omit the\n    name to list every system with a one-line summary. Use for \"what scoring system should I use\", \"how does\n    negative marking work\", \"list every scoring system you know\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A scoring system's name or alias; omit to list every system.","examples":["flat points","wagering","negative marking"],"title":"Name"}},"title":"scoring_systemArguments","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/tiebreaker_method":{"post":{"operationId":"tiebreaker_method","summary":"Explains one way to break a tie at the end of a trivia night: how it works, hosting tips, and what","description":"Explains one way to break a tie at the end of a trivia night: how it works, hosting tips, and what\n    situation it suits. Omit the name to list every method with a one-line summary. Use for \"how do I break a\n    tie in trivia\", \"what's a countback\", \"list every tiebreaker method you know\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A tiebreaker method's name or alias; omit to list every method.","examples":["sudden death","closest without going over","countback"],"title":"Name"}},"title":"tiebreaker_methodArguments","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_idea_generator":{"post":{"operationId":"category_idea_generator","summary":"Suggests 6-8 sub-category angles for a themed trivia night, e.g. \"movies\" -> decade deep-dives, movie","description":"Suggests 6-8 sub-category angles for a themed trivia night, e.g. \"movies\" -> decade deep-dives, movie\n    quotes, behind-the-camera trivia, award winners, and more. Matches a curated theme first (movies, music,\n    television, sports, history, geography, science, literature, food & drink, video games, pop culture,\n    animals & nature, art & design, technology, holidays & seasons); falls back to a generic set of angle\n    templates for any other theme. Use for \"give me sub-categories for a movies trivia night\", \"ideas for a\n    space-themed quiz round\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"theme":{"description":"A trivia-night theme to generate sub-category angles for.","examples":["movies","music","80s nostalgia","space exploration"],"minLength":1,"title":"Theme","type":"string"}},"required":["theme"],"title":"category_idea_generatorArguments","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/round_structure_planner":{"post":{"operationId":"round_structure_planner","summary":"Builds a suggested round-by-round schedule for a trivia night: a recommended format for each round","description":"Builds a suggested round-by-round schedule for a trivia night: a recommended format for each round\n    (starting with an easy warm-up, ending on a strong finish, with a wager round placed once points are on the\n    board), a time budget per round, and a suggested question count, given a total event length and desired\n    number of rounds. Also suggests an intro/outro budget and whether a halfway break fits. Use for \"help me\n    plan a 90 minute quiz with 6 rounds\", \"how should I structure a 2 hour trivia night\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"total_time":{"description":"Total event length in minutes.","examples":[60,90,120],"maximum":240,"minimum":15,"title":"Total Time","type":"integer"},"num_rounds":{"description":"How many rounds to plan for.","examples":[4,5,6],"maximum":12,"minimum":1,"title":"Num Rounds","type":"integer"}},"required":["total_time","num_rounds"],"title":"round_structure_plannerArguments","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 trivia-hosting lingo — pub quiz, buzzer, halfway break, marking scheme, blind","description":"Definitions of common trivia-hosting lingo — pub quiz, buzzer, halfway break, marking scheme, blind\n    marking, peer marking, countback, dead heat, round robin, honor system, leaderboard, accumulator question,\n    rebound question, and more. Use for \"what's a countback\", \"what does 'blind marking' mean\", \"what's a dead\n    heat in trivia\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific hosting 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/beginner_tips":{"post":{"operationId":"beginner_tips","summary":"A ranked shortlist of the most useful, practical tips for a first-time trivia host, from most to least","description":"A ranked shortlist of the most useful, practical tips for a first-time trivia host, from most to least\n    essential. Use for \"tips for a first-time quiz host\", \"what should I know before hosting my first trivia\n    night\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"count":{"default":5,"description":"How many tips to return.","maximum":14,"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}}}}