{"openapi":"3.1.0","info":{"title":"Backyardsport API","version":"0.1.0","description":"A fully local, hand-curated reference for informal backyard and street games: Wiffle ball, backyard/street cricket, street hockey, stickball, four square, kickball, tetherball, and hacky sack/footbag, with how-to-play summaries, common house-rule variants, DIY equipment tips, scoring, beginner tips, a space-based recommender and a glossary — honest that these are house-rules-heavy pickup games, not games with one fixed rulebook.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://backyardsport.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/backyardsport/docs"},"termsOfService":"https://connectorbay.com/backyardsport/terms"},"servers":[{"url":"https://backyardsport.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/backyardsport/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 informal backyard/street game: category, typical player count, how the space is","description":"Full detail for one informal backyard/street game: category, typical player count, how the space is\n    usually set up, common equipment, a numbered how-to-play summary, and a short history/trademark note. Use for\n    \"how do you play stickball\", \"what are the rules of kickball\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A game's name or alias.","examples":["wiffle ball","backyard cricket","four square","stickball"],"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/house_rule_variant":{"post":{"operationId":"house_rule_variant","summary":"Common regional/house-rule variations for one game (e.g. \"six and out\" in backyard cricket, the \"no-raise\"","description":"Common regional/house-rule variations for one game (e.g. \"six and out\" in backyard cricket, the \"no-raise\"\n    rule in street hockey). These are widely-seen examples, not an exhaustive or authoritative list — groups\n    invent their own constantly. Use for \"what house rules do people use for kickball\", \"common variants of four\n    square\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A game's name or alias.","examples":["backyard cricket","street hockey","tetherball"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"house_rule_variantArguments","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/equipment_diy_tip":{"post":{"operationId":"equipment_diy_tip","summary":"Ideas for improvising equipment for one game when you don't have the \"real\" gear — chalk-drawn bases,","description":"Ideas for improvising equipment for one game when you don't have the \"real\" gear — chalk-drawn bases,\n    a broomstick bat, a sock filled with rice as a footbag, and similar common substitutions. Use for \"how do I\n    make a homemade hacky sack\", \"what can I use instead of cones for kickball bases\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A game's name or alias.","examples":["wiffle ball","hacky sack","tetherball"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"equipment_diy_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/term_glossary":{"post":{"operationId":"term_glossary","summary":"Definitions of terms used across these games — ghost runner, house rules, sewer distance, holds, the","description":"Definitions of terms used across these games — ghost runner, house rules, sewer distance, holds, the\n    wrap, footbag, and more — each tagged with the game it comes from, or \"General\" if it's used across\n    several. Use for \"what's a ghost runner\", \"what does 'six and out' mean\".","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/find_game_for_space":{"post":{"operationId":"find_game_for_space","summary":"Suggests 1-4 games well suited to a described play space, keyword-matched against each game's typical","description":"Suggests 1-4 games well suited to a described play space, keyword-matched against each game's typical\n    space needs. Use for \"what game works in a narrow alley\", \"we just have a small driveway, what can we play\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"space_description":{"description":"A play space, in plain language.","examples":["a narrow city alley","a big open backyard","a small paved driveway","a backyard with a pole already in the ground"],"minLength":1,"title":"Space Description","type":"string"}},"required":["space_description"],"title":"find_game_for_spaceArguments","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_summary":{"post":{"operationId":"scoring_summary","summary":"A short summary of how scoring typically works for one game. Use for \"how do you win at tetherball\", \"how","description":"A short summary of how scoring typically works for one game. Use for \"how do you win at tetherball\", \"how\n    is backyard cricket scored\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A game's name or alias.","minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"scoring_summaryArguments","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 categories of backyard games do you","description":"Every game category with how many games are in it. Use for \"what categories of backyard games do you\n    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 short list of tips for someone trying a game for the first time, plus relevant safety notes for games","description":"A short list of tips for someone trying a game for the first time, plus relevant safety notes for games\n    with real physical risk (traffic, a tetherball rope and pole, a hard ball near windows). Use for \"any tips\n    for a beginner playing four square\", \"what should I know before my first game of street hockey\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A game's name or alias.","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}}}}