{"openapi":"3.1.0","info":{"title":"Game Brain (BYOK) API","version":"0.1.0","description":"Game Brain (BYOK) lets an AI assistant read your own Game Brain data through the Game Brain API with a key you supply (Game Brain API key). Read-only: 5 tools (search_games, suggest_games, get_game, list_similar_games, list_game_news). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to api.gamebrain.co. Unofficial...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-gamebrain.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-gamebrain/docs"},"termsOfService":"https://connectorbay.com/byok-gamebrain/terms"},"servers":[{"url":"https://byok-gamebrain.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-gamebrain/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/search_games":{"post":{"operationId":"search_games","summary":"Search over 800,000 video games with a natural-language query and optional filters, returning name, year, genre, rating,","description":"Search over 800,000 video games with a natural-language query and optional filters, returning name, year, genre, rating, platforms and a short description. Costs one quota token per started block of 10 results. Use for \"Find medieval strategy games for PC, best rated first\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Natural-language search query, for example 'medieval strategy games'.","maxLength":200,"title":"Query","type":"string"},"offset":{"anyOf":[{"maximum":1000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Pagination offset, 0 to 1000.","title":"Offset"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Number of results to return, 1 to 50.","title":"Limit"},"filters":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"default":null,"description":"JSON array of filters, for example [{\"key\":\"platform\",\"values\":[{\"value\":\"pc\"}],\"connection\":\"OR\"},{\"key\":\"genre\",\"values\":[{\"value\":\"action\"}]}].","title":"Filters"},"sort":{"anyOf":[{"enum":["computed_rating","price","release_date"],"type":"string"},{"type":"null"}],"default":null,"description":"Field to sort by.","title":"Sort"},"sort_order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort direction.","title":"Sort Order"}},"required":["query"],"title":"search_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/suggest_games":{"post":{"operationId":"suggest_games","summary":"Autocomplete game titles from a partial name such as 'kingdom co'. Cheap lookup (0.1 quota token) for finding a game id.","description":"Autocomplete game titles from a partial name such as 'kingdom co'. Cheap lookup (0.1 quota token) for finding a game id. Use for \"Which games match 'kingdom co'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Partial search text.","maxLength":100,"title":"Query","type":"string"},"limit":{"anyOf":[{"maximum":10,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Number of suggestions to return, 1 to 10.","title":"Limit"}},"required":["query"],"title":"suggest_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/get_game":{"post":{"operationId":"get_game","summary":"Get full details for one game: description, release date, developer, ratings from players and critics, playtime, platfor","description":"Get full details for one game: description, release date, developer, ratings from players and critics, playtime, platforms, genres, themes, play modes, screenshots and videos. Use for \"Give me the details of Game Brain game 1273796\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Game Brain game id, from search_games or suggest_games.","minimum":1,"title":"Id","type":"integer"}},"required":["id"],"title":"get_gameArguments","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/list_similar_games":{"post":{"operationId":"list_similar_games","summary":"Find games similar to a given game, ranked by vector similarity of how people talk about them. Costs one quota token per","description":"Find games similar to a given game, ranked by vector similarity of how people talk about them. Costs one quota token per started block of 10 results. Use for \"What games are similar to game 33313\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Game Brain game id, from search_games or suggest_games.","minimum":1,"title":"Id","type":"integer"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Number of similar games to return, 1 to 50.","title":"Limit"}},"required":["id"],"title":"list_similar_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/list_game_news":{"post":{"operationId":"list_game_news","summary":"List news articles and tutorials that mention a game: title, link, source site, image and publish date. Costs one quota ","description":"List news articles and tutorials that mention a game: title, link, source site, image and publish date. Costs one quota token. Use for \"What is the latest news about game 1261640\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Game Brain game id, from search_games or suggest_games.","minimum":1,"title":"Id","type":"integer"},"offset":{"anyOf":[{"maximum":1000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of articles to skip.","title":"Offset"},"limit":{"anyOf":[{"maximum":10,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Number of articles to return, 1 to 10.","title":"Limit"}},"required":["id"],"title":"list_game_newsArguments","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}}}}