{"openapi":"3.1.0","info":{"title":"Playground API","version":"0.1.0","description":"A fully local, hand-curated reference to classic outdoor and playground games: hopscotch, jump rope & double dutch, tag and its variants (freeze tag, TV tag, flashlight tag), Red Rover, Simon Says, Mother May I, and circle/singing games (London Bridge, Ring Around the Rosie, Duck Duck Goose), plus Red Light Green Light — with how-to-play steps, real cross-cultural regional names, age guidance, and safety notes.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://playground.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/playground/docs"},"termsOfService":"https://connectorbay.com/playground/terms"},"servers":[{"url":"https://playground.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/playground/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_info":{"post":{"operationId":"game_info","summary":"Full detail for one playground game: category, players and setting, equipment, numbered how-to-play","description":"Full detail for one playground game: category, players and setting, equipment, numbered how-to-play\n    steps, real regional name variants across cultures, age guidance, and safety notes. Use for \"how do you\n    play hopscotch\", \"tell me about Red Rover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A game's name or alias.","examples":["hopscotch","red rover","duck duck goose"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"game_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/how_to_play":{"post":{"operationId":"how_to_play","summary":"Just the numbered how-to-play steps, players, setting, and equipment for one game — a shorter answer","description":"Just the numbered how-to-play steps, players, setting, and equipment for one game — a shorter answer\n    than game_info when someone only wants to know the rules. Use for \"how do you play Simon Says\", \"steps\n    for Mother May I\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A game's name or alias.","examples":["London Bridge","double dutch","flashlight tag"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"how_to_playArguments","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/game_by_region":{"post":{"operationId":"game_by_region","summary":"Real regional name variants for playground games in one country/region — for example \"Marelle\" for","description":"Real regional name variants for playground games in one country/region — for example \"Marelle\" for\n    hopscotch in France, \"Oni gokko\" for tag in Japan, or \"Duck Duck Grey Duck\" in Minnesota. Use for \"what\n    is hopscotch called in Germany\", \"regional names for tag\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"A country, region, or place name.","examples":["France","Japan","Minnesota","South Korea"],"minLength":1,"title":"Region","type":"string"}},"required":["region"],"title":"game_by_regionArguments","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 playground-game terms — It/tagger, base, freeze, no tag-backs, elimination","description":"Definitions of common playground-game terms — It/tagger, base, freeze, no tag-backs, elimination\n    game, circle game, turner, pepper, counting-out rhyme, caller, chant, potsy, statue, manhunt. Use for\n    \"what does 'pepper' mean in jump rope\", \"what's a counting-out rhyme\".","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/age_appropriateness":{"post":{"operationId":"age_appropriateness","summary":"A game's typical age range plus a short qualitative note on who it suits best (very young children,","description":"A game's typical age range plus a short qualitative note on who it suits best (very young children,\n    older kids, mixed-age groups...) and, for higher-contact games, an age-related safety caution. Use for\n    \"what age is Duck Duck Goose good for\", \"is Red Rover okay for a 6-year-old\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A game's name or alias.","examples":["Ring Around the Rosie","Red Rover","TV Tag"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"age_appropriatenessArguments","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":"Safety notes for one game — most relevant for games with real running, chasing, or physical-contact","description":"Safety notes for one game — most relevant for games with real running, chasing, or physical-contact\n    risk (tag variants, and especially Red Rover, which has a documented history of collision injuries).\n    Games with little to no physical risk get a short note saying so. Use for \"is Red Rover safe\", \"any\n    safety concerns with flashlight tag\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A game's name or alias.","examples":["Red Rover","flashlight tag","hopscotch"],"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_setting":{"post":{"operationId":"find_game_for_setting","summary":"Suggests games that fit a stated setting (matched to indoor/outdoor when recognizable) and, if given,","description":"Suggests games that fit a stated setting (matched to indoor/outdoor when recognizable) and, if given,\n    a group size that must fit the game's usual player range. Use for \"games for 6 kids in a small\n    backyard\", \"indoor games for a rainy afternoon\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"setting":{"description":"A setting or place, in plain language.","examples":["small backyard","gym class","rainy day indoors","birthday party at a park"],"minLength":1,"title":"Setting","type":"string"},"group_size":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Number of players, if known.","title":"Group Size"}},"required":["setting"],"title":"find_game_for_settingArguments","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 playground games do you cover\".","description":"Every game category with how many games are in it. Use for \"what kinds of playground 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}}}}