{"openapi":"3.1.0","info":{"title":"Capture API","version":"0.1.0","description":"A fully local, hand-curated reference for outdoor group games: Capture the Flag, Manhunt, Kick the Can, Sardines, Hide and Seek, Ghost in the Graveyard, and Steal the Bacon, with original how-to-play rules, field/space requirements, variants, beginner tips, a shared glossary, and genuine safety notes for boundary-setting and nighttime/large-area play.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://capture.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/capture/docs"},"termsOfService":"https://connectorbay.com/capture/terms"},"servers":[{"url":"https://capture.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/capture/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/game_rules":{"post":{"operationId":"game_rules","summary":"Full detail for one outdoor group game: category, player count range, setup steps, numbered how-to-play","description":"Full detail for one outdoor group game: category, player count range, setup steps, numbered how-to-play\n    rules, difficulty and typical duration. Use for \"how do you play capture the flag\", \"what are the rules of\n    steal the bacon\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A game's name or alias.","examples":["Capture the Flag","Manhunt","Sardines"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"game_rulesArguments","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 outdoor-game terms -- boundary, home base, jail, tag, rescue, convert rule,","description":"Definitions of common outdoor-game terms -- boundary, home base, jail, tag, rescue, convert rule,\n    glow marker, safe zone, and more. Use for \"what does jail mean in these games\", \"what's a convert rule\".","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/space_requirement":{"post":{"operationId":"space_requirement","summary":"A game's field/space needs: minimum and ideal area, terrain notes, and whether a marked boundary is","description":"A game's field/space needs: minimum and ideal area, terrain notes, and whether a marked boundary is\n    needed. Use for \"how much space do I need for manhunt\", \"can I play ghost in the graveyard in a small yard\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A game's name or alias.","examples":["Capture the Flag","Kick the Can"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"space_requirementArguments","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/safety_note":{"post":{"operationId":"safety_note","summary":"A game's specific safety notes, plus the general boundary-setting note that applies to every game here.","description":"A game's specific safety notes, plus the general boundary-setting note that applies to every game here.\n    Games commonly played after dark also get the nighttime visibility/boundary note. Use for \"is manhunt safe\n    to play at night\", \"what should we watch out for playing capture the flag\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A game's name or alias.","examples":["Ghost in the Graveyard","Manhunt"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"safety_noteArguments","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_game_for_group":{"post":{"operationId":"find_game_for_group","summary":"Suggests games that fit a player count, an optional setting, and an optional time of day. Requesting","description":"Suggests games that fit a player count, an optional setting, and an optional time of day. Requesting\n    'dusk' or 'night' restricts results to games commonly played after dark. Use for \"what game works for 12\n    kids in a backyard\", \"good nighttime game for 20 people at a campground\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"player_count":{"description":"How many players you have.","examples":[8,15,30],"maximum":200,"minimum":1,"title":"Player Count","type":"integer"},"setting":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Where you'll play, in plain language.","examples":["backyard","park","campground","gym","neighborhood","indoors"],"title":"Setting"},"time_of_day":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"When you'll play.","examples":["day","dusk","night"],"title":"Time Of Day"}},"required":["player_count"],"title":"find_game_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/variant_info":{"post":{"operationId":"variant_info","summary":"A game's known variants, each tagged with its parent game name. If `name` matches a variant directly","description":"A game's known variants, each tagged with its parent game name. If `name` matches a variant directly\n    (not a base game), returns just that variant. Use for \"what variants of kick the can are there\", \"what is\n    flashlight tag manhunt\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A game's name, or a specific variant's name.","examples":["Manhunt","Flashlight Tag Manhunt"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"variant_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/category_list":{"post":{"operationId":"category_list","summary":"Every game category with how many games are in it. Use for \"what kinds of outdoor games do you cover\".","description":"Every game category with how many games are in it. Use for \"what kinds of outdoor games 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 tips for introducing a group to a game for the first time. Use for \"how do I","description":"A curated shortlist of tips for introducing a group to a game for the first time. Use for \"how do I\n    explain capture the flag to first-timers\", \"tips for a group's first game of manhunt\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A game's name or alias.","examples":["Capture the Flag","Sardines"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"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}}}}