{"openapi":"3.1.0","info":{"title":"Marble API","version":"0.1.0","description":"A fully local, hand-curated marbles (the game) reference: rules for eight classic marbles games worldwide (Ring Taw/Ringer, Bridgeboard, Nine Holes, Bombies, Long Taw, Increase Pound, Ducks on a Rock, Nearest the Hole), a marble-type glossary, general game terminology, a group/space game finder, regional traditions across the UK, US, Germany, India, the Netherlands and Southeast Asia, and a short history note.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://marble.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/marble/docs"},"termsOfService":"https://connectorbay.com/marble/terms"},"servers":[{"url":"https://marble.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/marble/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 marbles game: category, equipment, setup steps, numbered how-to-play steps, how a","description":"Full detail for one marbles game: category, equipment, setup steps, numbered how-to-play steps, how a\n    round is won, common variants, and a short origin note. Use for \"how do you play Ringer\", \"what are the\n    rules of Nine Holes\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A marbles game's name or alias.","examples":["Ring Taw","Ringer","Bridgeboard","Nine Holes","Long Taw"],"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/marble_type_glossary":{"post":{"operationId":"marble_type_glossary","summary":"Definitions of marble-type/material terms — aggie, cat's eye, steelie, peewee, bumboozer, clearie, swirl,","description":"Definitions of marble-type/material terms — aggie, cat's eye, steelie, peewee, bumboozer, clearie, swirl,\n    cloudy, onionskin, sulphide, corkscrew, mica, Bennington, commoney, immie. Use for \"what's a cat's eye\n    marble\", \"what does aggie mean\", \"what marble types are there\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific marble-type term to look up; omit to list all.","examples":["aggie","cat's eye","steelie","sulphide"],"title":"Term"}},"title":"marble_type_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/term_glossary":{"post":{"operationId":"term_glossary","summary":"Definitions of general marbles game terminology (as opposed to marble-type/material terms) — taw,","description":"Definitions of general marbles game terminology (as opposed to marble-type/material terms) — taw,\n    shooter, mib, knuckle down, fudging, span, fen, lag, for keeps, friendlies, pound, ducks, baseline, and\n    more. Use for \"what does knuckle down mean\", \"what's a taw\", \"what does fen mean in marbles\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific game term to look up; omit to list all.","examples":["taw","knuckle down","span","fen","lag"],"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_group":{"post":{"operationId":"find_game_for_group","summary":"Suggests 1-4 marbles games that fit a given player count and/or play space, keyword-matched against each","description":"Suggests 1-4 marbles games that fit a given player count and/or play space, keyword-matched against each\n    game's player range and tagged space requirements. Use for \"what marbles game works for 3 kids indoors\",\n    \"we have a big backyard and 6 players, what should we play\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"player_count":{"anyOf":[{"maximum":30,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"How many players. Omit to ignore this constraint.","examples":[2,4,6],"title":"Player Count"},"space":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A plain-language description of the play space. Omit to ignore this constraint.","examples":["small indoor room","big backyard","classroom floor","long hallway","flat dirt outside"],"title":"Space"}},"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/history_note":{"post":{"operationId":"history_note","summary":"A short history of marbles as a game: early materials, the rise of handmade and then machine-made glass","description":"A short history of marbles as a game: early materials, the rise of handmade and then machine-made glass\n    marbles, and the separate historical roots of ring-and-taw versus hole-and-course games. Use for \"how did\n    marbles start\", \"history of marbles\", \"when were glass marbles invented\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"history_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/regional_tradition":{"post":{"operationId":"regional_tradition","summary":"A factual note on how marbles is played, named, and organized in one region or country — including","description":"A factual note on how marbles is played, named, and organized in one region or country — including\n    India's Kancha/Goli tradition, the UK's Tinsley Green tournament, the US National Marbles Tournament,\n    Germany's glassmaking history, the Netherlands' knikkeren tradition, and Southeast Asia's local names. Use\n    for \"how is marbles played in India\", \"marbles tradition in the Netherlands\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"A region or country name.","examples":["United Kingdom","United States","Germany","India","Netherlands","Southeast Asia"],"minLength":1,"title":"Region","type":"string"}},"required":["region"],"title":"regional_traditionArguments","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 marbles game category with how many games are in it (Ring Games, Hole & Board Games, Target","description":"Every marbles game category with how many games are in it (Ring Games, Hole & Board Games, Target\n    Games, Chase Games, Pot Games, Casual Games). Use for \"what kinds of marbles 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":"Practical starting tips for a beginner. Given a game name, returns tips specific to that game; with no","description":"Practical starting tips for a beginner. Given a game name, returns tips specific to that game; with no\n    name, returns general getting-started tips that apply across marbles games. Use for \"tips for playing\n    Ringer\", \"how do I get started with marbles\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A marbles game's name or alias; omit for general getting-started tips.","examples":["Ring Taw","Nine Holes"],"title":"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}}}}