{"openapi":"3.1.0","info":{"title":"Boardgeek API","version":"0.1.0","description":"A fully local, hand-curated board-game collecting & organizing reference: storage/shelving tips, real card-sleeve size data, cataloging approaches, how community rating/weight systems conceptually work, condition/preservation tips, a collection-size shelf-space planner, and a collecting-hobby glossary. Hobby logistics, not a game-info database.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://boardgeek.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/boardgeek/docs"},"termsOfService":"https://connectorbay.com/boardgeek/terms"},"servers":[{"url":"https://boardgeek.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/boardgeek/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/storage_tip":{"post":{"operationId":"storage_tip","summary":"Practical tips for one board-game storage/organizing topic (shelving, stacking, inserts, sleeved-card","description":"Practical tips for one board-game storage/organizing topic (shelving, stacking, inserts, sleeved-card\n    storage, binders, expansions, labeling, travel/transport, overflow & culling, small spaces). Use for \"how\n    should I store my board games\", \"what do I do with an overflowing collection\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A storage/organizing topic; omit to list all topics.","examples":["shelving","insert organizers","sleeved cards","small space"],"title":"Topic"}},"title":"storage_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/sleeving_guide":{"post":{"operationId":"sleeving_guide","summary":"Real reference dimensions for a named card-sleeve size, plus general sleeving tips. Sizes marked","description":"Real reference dimensions for a named card-sleeve size, plus general sleeving tips. Sizes marked\n    'approximate' vary a little between sleeve manufacturers — always measure your own card first. Use for \"what\n    size sleeves fit Catan\", \"how big are mini American sleeves\", \"what's tarot card size\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"card_size":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A card-sleeve size name; omit to list all sizes.","examples":["standard","mini american","mini euro","tarot"],"title":"Card Size"}},"title":"sleeving_guideArguments","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/cataloging_approach":{"post":{"operationId":"cataloging_approach","summary":"One approach to cataloging a board game collection — spreadsheet, dedicated app, barcode scanning,","description":"One approach to cataloging a board game collection — spreadsheet, dedicated app, barcode scanning,\n    physical index cards, insurance photo inventory, tagging schemes, loan tracking, play logging, or value\n    notes — with pros, cons, and who it best suits. Use for \"how do I catalog my board game collection\", \"should\n    I use a spreadsheet or an app\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A cataloging approach or topic; omit to list all.","examples":["spreadsheet","barcode scanning","loan tracking"],"title":"Topic"}},"title":"cataloging_approachArguments","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/rating_system_explainer":{"post":{"operationId":"rating_system_explainer","summary":"Explains, generically and conceptually, how community game-rating/weight systems in this hobby tend to","description":"Explains, generically and conceptually, how community game-rating/weight systems in this hobby tend to\n    work (raw vs. weighted average, complexity/weight scale, rank vs. rating, player-count voting, hotness\n    rankings, personal vs. community ratings, review vs. rating, outlier handling). Describes general concepts,\n    not any specific site's actual database or scores. Use for \"how does a weighted board game rating work\",\n    \"what's the difference between rating and rank\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A rating-system concept; omit to list all.","examples":["bayesian average","complexity weight","rank vs rating"],"title":"Topic"}},"title":"rating_system_explainerArguments","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/preservation_tip":{"post":{"operationId":"preservation_tip","summary":"Condition and preservation tips for board games — sunlight/UV, humidity/warping, box/lid crushing, corner","description":"Condition and preservation tips for board games — sunlight/UV, humidity/warping, box/lid crushing, corner\n    wear, card handling wear, token care, rulebook care, cleaning, pests, moving, and consolidating boxes. Use\n    for \"how do I protect my games from humidity\", \"how do I clean plastic miniatures\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A condition/preservation topic; omit to list all.","examples":["humidity","sunlight","card wear","moving house"],"title":"Topic"}},"title":"preservation_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/collection_size_planner":{"post":{"operationId":"collection_size_planner","summary":"Estimates shelf space for a given collection size: linear shelf cm/in (low/typical/high range), how many","description":"Estimates shelf space for a given collection size: linear shelf cm/in (low/typical/high range), how many\n    standard bookshelf shelves or cube-storage units that implies, and a size-appropriate recommendation. States\n    its box-size assumptions explicitly since real box footprints vary hugely. Use for \"how much shelf space do I\n    need for 80 games\", \"how many Kallax cubes for 200 board games\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"num_games":{"description":"How many games are (or will be) in the collection.","examples":[25,80,300],"maximum":10000,"minimum":1,"title":"Num Games","type":"integer"}},"required":["num_games"],"title":"collection_size_plannerArguments","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 collecting-hobby vocabulary — FLGS, shelf of shame, insert, sleeved, mint in shrink, near","description":"Definitions of collecting-hobby vocabulary — FLGS, shelf of shame, insert, sleeved, mint in shrink, near\n    mint, played condition, box wear, ding, KS exclusive, print-and-play, big box, component upgrade, geeklist,\n    trade pile, table presence, punchboard, meeple. Distinct from game-mechanism terminology. Use for \"what does\n    'shelf of shame' mean\", \"what's a KS exclusive\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific collecting-hobby 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/beginner_tips":{"post":{"operationId":"beginner_tips","summary":"A curated shortlist of practical tips for someone just starting to build and organize a board game","description":"A curated shortlist of practical tips for someone just starting to build and organize a board game\n    collection, ordered from most to least essential. Use for \"tips for a new board game collector\", \"what\n    should I know before my collection gets big\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"count":{"default":5,"description":"How many tips to return.","maximum":12,"minimum":1,"title":"Count","type":"integer"}},"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}}}}