{"openapi":"3.1.0","info":{"title":"Shedding API","version":"0.1.0","description":"A fully local, hand-curated reference for shedding-family card games: Crazy Eights, Switch, Mao, Presidents, Palace, Egyptian Ratscrew, Cheat, Big Two and Durak, with original how-to-play summaries, special-card effects, notable variants, player-count fit, beginner tips and a cross-game glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://shedding.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/shedding/docs"},"termsOfService":"https://connectorbay.com/shedding/terms"},"servers":[{"url":"https://shedding.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/shedding/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 shedding-family card game: category, deck/setup, numbered how-to-play steps,","description":"Full detail for one shedding-family card game: category, deck/setup, numbered how-to-play steps,\n    scoring, difficulty and typical duration. Use for \"how do you play Crazy Eights\", \"what's the setup for\n    Palace\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A shedding game's name or alias.","examples":["Crazy Eights","Palace","Durak"],"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 cross-game shedding terms — wild card, trump suit, revolution, burn the pile,","description":"Definitions of common cross-game shedding terms — wild card, trump suit, revolution, burn the pile,\n    bluff, slap, climbing game, house rule, and more. Use for \"what does 'burn the pile' mean\", \"what's a\n    trump suit\".","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/games_by_player_count":{"post":{"operationId":"games_by_player_count","summary":"Every game whose stated player-count range covers the given number, closest-fit-for-that-size first.","description":"Every game whose stated player-count range covers the given number, closest-fit-for-that-size first.\n    Use for \"what card games work for 6 people\", \"any shedding game for exactly 2 players\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"count":{"description":"Number of players.","examples":[2,4,6],"maximum":12,"minimum":1,"title":"Count","type":"integer"}},"required":["count"],"title":"games_by_player_countArguments","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/special_card_effects":{"post":{"operationId":"special_card_effects","summary":"A game's special-card mechanics — skip, reverse, wild, draw-two-style forced draws, pile-reset/burn,","description":"A game's special-card mechanics — skip, reverse, wild, draw-two-style forced draws, pile-reset/burn,\n    bomb/trump effects and the like — described generically rather than tied to any single branded product.\n    Use for \"what does the two do in Switch\", \"what's a revolution in Presidents\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"game":{"description":"A shedding game's name or alias.","examples":["Switch","Presidents","Palace"],"minLength":1,"title":"Game","type":"string"}},"required":["game"],"title":"special_card_effectsArguments","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 games that fit a stated player count and mood/vibe, keyword-matched against each game's","description":"Suggests 1-4 games that fit a stated player count and mood/vibe, keyword-matched against each game's\n    mechanic category and tagged mood. Use for \"suggest a fast chaotic card game for 5 people\", \"quiet\n    strategic game for two\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"player_count":{"description":"Number of players.","examples":[4,5],"maximum":12,"minimum":1,"title":"Player Count","type":"integer"},"mood":{"description":"The vibe you're after, in plain language.","examples":["fast and chaotic","quiet bluffing game","big rowdy party","two-player strategic"],"minLength":1,"title":"Mood","type":"string"}},"required":["player_count","mood"],"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/category_list":{"post":{"operationId":"category_list","summary":"Every shedding-game mechanic category (match & wild-card, climbing & comparison, bluffing & deception,","description":"Every shedding-game mechanic category (match & wild-card, climbing & comparison, bluffing & deception,\n    and so on) with how many games are in it. Use for \"what kinds of shedding 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/variant_info":{"post":{"operationId":"variant_info","summary":"A game's notable regional or house-rule variants, each with a short original description. Use for","description":"A game's notable regional or house-rule variants, each with a short original description. Use for\n    \"what variants of Presidents are there\", \"house rules for Egyptian Ratscrew\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A shedding game's name or alias.","examples":["Presidents","Egyptian Ratscrew"],"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/beginner_tips":{"post":{"operationId":"beginner_tips","summary":"A short list of practical tips for a new player of one named game. Use for \"tips for a Durak","description":"A short list of practical tips for a new player of one named game. Use for \"tips for a Durak\n    beginner\", \"how do I not lose immediately at Mao\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A shedding game's name or alias.","examples":["Big Two","Mao"],"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}}}}