{"openapi":"3.1.0","info":{"title":"Spintop API","version":"0.1.0","description":"A fully local, hand-curated worldwide spinning-top games reference: traditional wound-string and whip tops across cultures (Japanese beigoma, Filipino trumpo/turumpo, Indian lattoo/bambaram, Latin American trompo, European whip/peg tops), the Hanukkah dreidel game with accurate rules and letter meanings, and a generic, non-trademarked description of modern launcher battling-top mechanics, plus terminology, regional traditions, spin technique tips, category browsing and beginner tips.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://spintop.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/spintop/docs"},"termsOfService":"https://connectorbay.com/spintop/terms"},"servers":[{"url":"https://spintop.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/spintop/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 spinning-top game or tradition: category, region, origin note, materials, numbered","description":"Full detail for one spinning-top game or tradition: category, region, origin note, materials, numbered\n    how-to-play steps, typical variants/games, a fun fact, and beginner tips. Use for \"how do you play beigoma\",\n    \"what is a turumpo\", \"tell me about the dreidel game\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A spinning-top game's name or alias.","examples":["beigoma","trompo","lattoo","dreidel"],"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/term_glossary":{"post":{"operationId":"term_glossary","summary":"Definitions of spinning-top terminology -- sleep, wobble/precession, true spin, gyroscopic effect, string","description":"Definitions of spinning-top terminology -- sleep, wobble/precession, true spin, gyroscopic effect, string\n    groove, ripcord launcher, spin-out, ring-out/knockout, attack/defense/stamina/balance type, gelt, ante,\n    sevivon, and more. Use for \"what does 'sleep' mean for a top\", \"what's a ring-out\".","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.","examples":["sleep","wobble","ripcord launcher","gelt"],"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/regional_tradition":{"post":{"operationId":"regional_tradition","summary":"The broader cultural context and history for one region's spinning-top tradition, plus which games in this","description":"The broader cultural context and history for one region's spinning-top tradition, plus which games in this\n    reference belong to it. Use for \"tell me about spinning tops in Japan\", \"what's the history of spinning tops\n    in India\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"A region or country name.","examples":["Japan","India","Philippines","Latin America","Europe"],"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/dreidel_rules":{"post":{"operationId":"dreidel_rules","summary":"The complete, accurate rules of the Hanukkah dreidel game: how to play, the four Hebrew letters and what","description":"The complete, accurate rules of the Hanukkah dreidel game: how to play, the four Hebrew letters and what\n    each one means and does (including the Israel/diaspora Pe-vs-Shin difference), materials, etymology, and a\n    respectful history note covering both the popular Hanukkah-era legend and the better-documented European\n    teetotum origin some historians trace for the game. Use for \"how do you play dreidel\", \"what does gimel mean\n    on a dreidel\", \"why is a dreidel from Israel different\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"dreidel_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/spin_technique_tip":{"post":{"operationId":"spin_technique_tip","summary":"A practical technique tip for one aspect of spinning-top play -- winding a string evenly, timing a throw,","description":"A practical technique tip for one aspect of spinning-top play -- winding a string evenly, timing a throw,\n    choosing a surface, keeping a whip top going, launching a modern battling top, catching a top on your palm,\n    keeping the spin axis true, or practicing as a beginner. Use for \"how do I wind the string\", \"how do I keep a\n    whip top spinning\", \"tips for launching a battling top\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A technique topic to look up; omit to list all.","examples":["winding the string","throw release","whip maintenance","ripcord launch","palm catch"],"title":"Topic"}},"title":"spin_technique_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/find_game_by_region":{"post":{"operationId":"find_game_by_region","summary":"Every spinning-top game in this reference tied to a given region or country. Use for \"what spinning top","description":"Every spinning-top game in this reference tied to a given region or country. Use for \"what spinning top\n    games come from India\", \"is there a Japanese spinning top game\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"A region or country name.","examples":["Japan","India","Philippines","Latin America","Europe","Israel"],"minLength":1,"title":"Region","type":"string"}},"required":["region"],"title":"find_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/category_list":{"post":{"operationId":"category_list","summary":"Every spinning-top game category in this reference with how many games are in it. Use for \"what categories","description":"Every spinning-top game category in this reference with how many games are in it. Use for \"what categories\n    of spinning top 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":"A beginner-friendly shortlist of tips for learning one named spinning-top game. Use for \"how do I learn to","description":"A beginner-friendly shortlist of tips for learning one named spinning-top game. Use for \"how do I learn to\n    play trompo\", \"beginner tips for beigoma\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A spinning-top game's name or alias.","examples":["beigoma","trompo","dreidel"],"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}}}}