{"openapi":"3.1.0","info":{"title":"Redemption API","version":"0.1.0","description":"A fully local, hand-curated reference for redemption/ticket arcade games: skee-ball, claw and crane machines, whack-a-mole-style strike games, coin pushers, spin/drop wheels, basketball and shooting-gallery games, and video redemption cabinets across 7 categories, plus arcade terminology, ticket-economics concepts, classic redemption-arcade history, and factual, hedged notes on claw-machine regulation.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://redemption.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/redemption/docs"},"termsOfService":"https://connectorbay.com/redemption/terms"},"servers":[{"url":"https://redemption.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/redemption/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 redemption/ticket arcade game: category, how it mechanically works, a skill-vs-","description":"Full detail for one redemption/ticket arcade game: category, how it mechanically works, a skill-vs-\n    chance classification, how its ticket payout conceptually works, typical venues, and beginner tips. Use\n    for \"how does a claw machine work\", \"what is a coin pusher\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A redemption arcade game's name or alias.","examples":["skee-ball","claw machine","coin pusher","whac-a-mole"],"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/game_search":{"post":{"operationId":"game_search","summary":"Keyword search across every game's name, aliases, category, mechanism, ticket mechanic and tips. Use","description":"Keyword search across every game's name, aliases, category, mechanism, ticket mechanic and tips. Use\n    for \"games with a mallet\", \"chance-based ticket games\", \"games that use a joystick\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword to search for.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"game_searchArguments","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 redemption-game category with how many games are in it (Ball & Roll, Claw & Crane, Mechanical","description":"Every redemption-game category with how many games are in it (Ball & Roll, Claw & Crane, Mechanical\n    Strike, Push & Pusher, Wheel/Spin/Drop, Sports & Shooting, Video Redemption). Use for \"what categories of\n    arcade 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/claw_machine_facts":{"post":{"operationId":"claw_machine_facts","summary":"Factual, hedged notes on how claw/crane machines are mechanically tuned and how they're treated under","description":"Factual, hedged notes on how claw/crane machines are mechanically tuned and how they're treated under\n    consumer-protection and amusement-device law in some jurisdictions (skill-vs-chance classification, prize\n    value caps, grip-strength tuning, licensing, international variation). General background only — never\n    legal or gambling advice, and regulation genuinely varies by place and time. Use for \"are claw machines\n    rigged\", \"are claw machines legal\", \"how is a claw machine different from a gambling machine\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific claw-machine regulatory/mechanical topic to look up; omit to list all.","examples":["grip strength tuning","prize value caps","skill vs chance"],"title":"Topic"}},"title":"claw_machine_factsArguments","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 redemption-arcade terms — prize counter, e-ticketing, merchandiser, route","description":"Definitions of common redemption-arcade terms — prize counter, e-ticketing, merchandiser, route\n    operator, FEC, pusher game, roll-down game, skill crane, midway, grip strength, prize wall. Use for\n    \"what's an FEC\", \"what does 'merchandiser' mean in an arcade\".","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/history_note":{"post":{"operationId":"history_note","summary":"Short, hedged historical notes on the redemption-arcade industry: claw-machine and Skee-Ball origins,","description":"Short, hedged historical notes on the redemption-arcade industry: claw-machine and Skee-Ball origins,\n    Whac-A-Mole's invention, Chuck E. Cheese's and Dave & Buster's founding, the mall-arcade boom, the shift\n    to e-ticketing, and the rise of video redemption games. Real venue/brand names are mentioned only as\n    factual historical examples. Use for \"when was Dave & Buster's founded\", \"history of Skee-Ball\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific historical topic, era, or game name to look up; omit to list all.","examples":["Whac-A-Mole invention","Chuck E. Cheese founding","e-ticketing"],"title":"Topic"}},"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/ticket_economics_explainer":{"post":{"operationId":"ticket_economics_explainer","summary":"Conceptually explains how redemption-game business economics work — payout percentage, ticket-to-","description":"Conceptually explains how redemption-game business economics work — payout percentage, ticket-to-\n    prize ratio, score-to-ticket curves, e-ticketing systems, the route-operator revenue-split model, prize-\n    wall tiering, and big-ticket-item marketing. Describes arcade-industry business concepts only — not\n    gambling, betting, or odds-optimization advice. Use for \"how do arcades decide how many tickets a prize\n    costs\", \"what's a route operator\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific ticket-economics topic to look up; omit to list all.","examples":["payout percentage","prize wall tiering","route operator model"],"title":"Topic"}},"title":"ticket_economics_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/find_game_for_venue_type":{"post":{"operationId":"find_game_for_venue_type","summary":"Suggests redemption games well-suited to a stated venue type, matched against each game's tagged","description":"Suggests redemption games well-suited to a stated venue type, matched against each game's tagged\n    typical venues (family entertainment center, pizza/restaurant arcade, bowling alley, adult eatertainment,\n    carnival midway, movie theater lobby, waterpark, small footprint venue). Use for \"what games work in a\n    small footprint\", \"best games for a family entertainment center\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"venue_type":{"description":"A venue to suggest games for, in plain language.","examples":["small bar arcade corner","family entertainment center","traveling carnival midway","movie theater lobby"],"minLength":1,"title":"Venue Type","type":"string"}},"required":["venue_type"],"title":"find_game_for_venue_typeArguments","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 specific game's technique tips for actually playing it well. Use for \"any tips for skee-ball\", \"how","description":"A specific game's technique tips for actually playing it well. Use for \"any tips for skee-ball\", \"how\n    do I win more at the claw machine\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A redemption arcade game's name or alias.","examples":["skee-ball","claw machine","basketball arcade"],"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}}}}