{"openapi":"3.1.0","info":{"title":"Arcade API","version":"0.1.0","description":"Chess players/games/puzzles/leaderboards, PC game deals and prices, free-to-play games, speedrun records, Pokémon, trivia.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://arcade.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/arcade/docs"},"termsOfService":"https://connectorbay.com/arcade/terms"},"servers":[{"url":"https://arcade.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/arcade/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/chess_player":{"post":{"operationId":"chess_player","summary":"A chess player's public profile and ratings: title, name, country, joined/last seen, followers, and per-mode","description":"A chess player's public profile and ratings: title, name, country, joined/last seen, followers, and per-mode\n    ratings with best ratings and win/loss/draw records (Chess.com) or games played and progress (Lichess). Use for\n    \"what's Hikaru's blitz rating\", \"Magnus's Lichess profile\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"username":{"description":"Username on the platform.","examples":["hikaru","DrNykterstein"],"title":"Username","type":"string"},"platform":{"default":"chess.com","description":"'chess.com' (default) or 'lichess'.","examples":["chess.com","lichess"],"title":"Platform","type":"string"}},"required":["username"],"title":"chess_playerArguments","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/chess_games":{"post":{"operationId":"chess_games","summary":"A player's most recent games: date, colour, opponent and ratings, result, time control, opening (ECO name) and a","description":"A player's most recent games: date, colour, opponent and ratings, result, time control, opening (ECO name) and a\n    link to the full game. Use for \"Hikaru's last games\", \"how did Magnus do today on Lichess\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"username":{"description":"Username on the platform.","examples":["hikaru"],"title":"Username","type":"string"},"platform":{"default":"chess.com","description":"'chess.com' or 'lichess'.","examples":["lichess"],"title":"Platform","type":"string"},"max_results":{"default":10,"maximum":30,"minimum":1,"title":"Max Results","type":"integer"}},"required":["username"],"title":"chess_gamesArguments","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/chess_puzzle":{"post":{"operationId":"chess_puzzle","summary":"Today's daily puzzle: position (FEN) and solution from Chess.com, or Lichess's daily puzzle with the game PGN,","description":"Today's daily puzzle: position (FEN) and solution from Chess.com, or Lichess's daily puzzle with the game PGN,\n    rating, themes and solution moves. Use for \"chess puzzle of the day\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"platform":{"default":"chess.com","description":"'chess.com' or 'lichess'.","examples":["lichess"],"title":"Platform","type":"string"}},"title":"chess_puzzleArguments","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/chess_leaderboard":{"post":{"operationId":"chess_leaderboard","summary":"The top-rated players on a platform for a time control or puzzles, with titles and ratings. Use for \"who's #1","description":"The top-rated players on a platform for a time control or puzzles, with titles and ratings. Use for \"who's #1\n    in bullet on Lichess\", \"Chess.com blitz leaderboard\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"platform":{"default":"chess.com","description":"'chess.com' or 'lichess'.","examples":["lichess"],"title":"Platform","type":"string"},"mode":{"default":"blitz","description":"bullet, blitz, rapid, daily (chess.com), classical/ultrabullet/chess960 (lichess), puzzles.","examples":["blitz"],"title":"Mode","type":"string"},"top":{"default":10,"maximum":50,"minimum":1,"title":"Top","type":"integer"}},"title":"chess_leaderboardArguments","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_deals":{"post":{"operationId":"game_deals","summary":"Current PC game deals across ~25 stores (Steam, GOG, Humble, Epic, Fanatical, GreenManGaming…) via CheapShark:","description":"Current PC game deals across ~25 stores (Steam, GOG, Humble, Epic, Fanatical, GreenManGaming…) via CheapShark:\n    sale and normal price, discount, Metacritic and Steam ratings, store and a deal link — filtered by title, price\n    cap, minimum discount or store. Use for \"is The Witcher 3 on sale\", \"best deals under $10\", \"AAA games 75% off\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Game title to search deals for; omit for the best current deals.","examples":["witcher","hades"],"title":"Title"},"max_price_usd":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Only deals at or under this price.","title":"Max Price Usd"},"min_savings_pct":{"anyOf":[{"maximum":100,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Only deals with at least this discount.","title":"Min Savings Pct"},"store":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Store name: Steam, GOG, Humble Store, Epic Games Store, Fanatical, GreenManGaming…","examples":["Steam"],"title":"Store"},"sort":{"default":"savings","description":"savings (default), price, rating (Metacritic), reviews, recent, deal.","examples":["savings"],"title":"Sort","type":"string"},"aaa_only":{"default":false,"description":"Only games with a normal price over $29.","title":"Aaa Only","type":"boolean"},"max_results":{"default":15,"maximum":60,"minimum":1,"title":"Max Results","type":"integer"}},"title":"game_dealsArguments","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_price":{"post":{"operationId":"game_price","summary":"A game's price picture: cheapest price right now, cheapest price ever (and when), and every store's current","description":"A game's price picture: cheapest price right now, cheapest price ever (and when), and every store's current\n    offer with discount and link. Use for \"cheapest price for Hades\", \"has Elden Ring ever been cheaper than $30\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"title":{"description":"Game title.","examples":["Hades","Elden Ring"],"title":"Title","type":"string"},"max_results":{"default":3,"maximum":5,"minimum":1,"title":"Max Results","type":"integer"}},"required":["title"],"title":"game_priceArguments","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/free_games":{"post":{"operationId":"free_games","summary":"Free-to-play PC and browser games from FreeToGame: title, genre, platform, publisher/developer, release date,","description":"Free-to-play PC and browser games from FreeToGame: title, genre, platform, publisher/developer, release date,\n    one-line description and link, filtered by genre and sorted by popularity or release. Use for \"best free shooters\",\n    \"new free MMORPGs\", \"free browser games\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"platform":{"default":"all","description":"'pc', 'browser' or 'all'.","examples":["pc"],"title":"Platform","type":"string"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Genre/tag: shooter, mmorpg, strategy, moba, racing, sports, card, battle-royale, fantasy, sci-fi, anime, survival, open-world, zombie, pvp, pve, 2d, 3d…","examples":["shooter","mmorpg"],"title":"Category"},"sort":{"default":"popularity","description":"popularity (default), release, alphabetical.","examples":["release"],"title":"Sort","type":"string"},"max_results":{"default":15,"maximum":50,"minimum":1,"title":"Max Results","type":"integer"}},"title":"free_gamesArguments","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/speedrun_records":{"post":{"operationId":"speedrun_records","summary":"World records on speedrun.com for a game: each main category with its rules summary and the top runs — time,","description":"World records on speedrun.com for a game: each main category with its rules summary and the top runs — time,\n    runner(s), date, platform, video and run page. Use for \"Celeste any% world record\", \"who holds the SM64 120-star\n    record\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"game":{"description":"Game title as on speedrun.com.","examples":["Celeste","Super Mario 64"],"title":"Game","type":"string"},"top":{"default":3,"description":"Runs per category.","maximum":10,"minimum":1,"title":"Top","type":"integer"}},"required":["game"],"title":"speedrun_recordsArguments","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/pokemon":{"post":{"operationId":"pokemon","summary":"A Pokémon's data: Dex number, genus, types, abilities (hidden marked), base stats and total, height/weight,","description":"A Pokémon's data: Dex number, genus, types, abilities (hidden marked), base stats and total, height/weight,\n    generation, legendary/mythical flags, capture rate, a Pokédex entry, evolution chain and official artwork. Use for\n    \"tell me about Gengar\", \"what type is Lucario\", \"Pikachu's base stats\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Pokémon name or National Dex number.","examples":["gengar","25"],"title":"Name","type":"string"}},"required":["name"],"title":"pokemonArguments","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/trivia":{"post":{"operationId":"trivia","summary":"Quiz questions from the Open Trivia Database with shuffled options and the correct answer, by category,","description":"Quiz questions from the Open Trivia Database with shuffled options and the correct answer, by category,\n    difficulty and type — for running a quiz in chat. Use for \"5 hard science questions\", \"true/false geography\n    trivia\", \"quiz me on history\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"amount":{"default":5,"description":"How many questions (1–20).","maximum":20,"minimum":1,"title":"Amount","type":"integer"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Category name or id: general, books, film, music, television, video games, science, computers, mathematics, mythology, sports, geography, history, politics, art, animals, vehicles, comics, anime…","examples":["science","geography"],"title":"Category"},"difficulty":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"easy, medium or hard.","examples":["hard"],"title":"Difficulty"},"kind":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"'multiple' (4 options) or 'boolean' (true/false).","examples":["multiple"],"title":"Kind"}},"title":"triviaArguments","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}}}}