{"openapi":"3.1.0","info":{"title":"MobyGames (BYOK) API","version":"0.1.0","description":"MobyGames (BYOK) lets an AI assistant read your own MobyGames data through the MobyGames API with a key you supply (MobyGames API key). Read-only: 10 tools (list_genres, list_platforms, search_games, get_game, list_recent_games, list_random_games, list_game_platforms, get_game_platform_release, list_game_screenshots, list_game_covers). The BYOK key travels with each request, is used for that one...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-mobygames.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-mobygames/docs"},"termsOfService":"https://connectorbay.com/byok-mobygames/terms"},"servers":[{"url":"https://byok-mobygames.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-mobygames/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/list_genres":{"post":{"operationId":"list_genres","summary":"List every MobyGames genre with its id, name and category. Use the ids to filter search_games. Use for \"What genres does","description":"List every MobyGames genre with its id, name and category. Use the ids to filter search_games. Use for \"What genres does MobyGames classify games into\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_genresArguments","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_platforms":{"post":{"operationId":"list_platforms","summary":"List every platform in the MobyGames database with its numeric id and name. Use for \"What is the MobyGames platform id f","description":"List every platform in the MobyGames database with its numeric id and name. Use for \"What is the MobyGames platform id for Windows 3.x\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_platformsArguments","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/search_games":{"post":{"operationId":"search_games","summary":"Search games by title text and optionally one genre id; returns matching games ordered by id. Use for \"Find games with '","description":"Search games by title text and optionally one genre id; returns matching games ordered by id. Use for \"Find games with 'Mordor' in the title\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"title":{"anyOf":[{"maxLength":128,"type":"string"},{"type":"null"}],"default":null,"description":"Text to match in the game title (maximum 128 characters).","title":"Title"},"genre":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only games of this genre id from list_genres.","title":"Genre"},"detail":{"anyOf":[{"enum":["brief","normal"],"type":"string"},{"type":"null"}],"default":"brief","description":"How much to return per game: brief (id, title, link) or normal (adds description, score, genres, platforms, sample images).","title":"Detail"}},"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/get_game":{"post":{"operationId":"get_game","summary":"Get one game by id: title, description, score, genres, platforms with first release year, and alternate titles. Use for ","description":"Get one game by id: title, description, score, genres, platforms with first release year, and alternate titles. Use for \"Tell me about the game with MobyGames id 31910\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"game_id":{"description":"MobyGames numeric game id, for example 31910. Find ids with search_games.","title":"Game Id","type":"integer"},"detail":{"anyOf":[{"enum":["brief","normal"],"type":"string"},{"type":"null"}],"default":"normal","description":"How much to return per game: brief (id, title, link) or normal (adds description, score, genres, platforms, sample images).","title":"Detail"}},"required":["game_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_recent_games":{"post":{"operationId":"list_recent_games","summary":"List games that were recently modified in MobyGames, as brief or normal records. Use for \"Which games were recently upda","description":"List games that were recently modified in MobyGames, as brief or normal records. Use for \"Which games were recently updated on MobyGames\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"detail":{"anyOf":[{"enum":["brief","normal"],"type":"string"},{"type":"null"}],"default":"brief","description":"How much to return per game: brief (id, title, link) or normal (adds description, score, genres, platforms, sample images).","title":"Detail"}},"title":"list_recent_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_random_games":{"post":{"operationId":"list_random_games","summary":"Return up to 100 random games (the list changes at most every five minutes), as brief or normal records. Use for \"Sugges","description":"Return up to 100 random games (the list changes at most every five minutes), as brief or normal records. Use for \"Suggest some random video games from MobyGames\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"detail":{"anyOf":[{"enum":["brief","normal"],"type":"string"},{"type":"null"}],"default":"brief","description":"How much to return per game: brief (id, title, link) or normal (adds description, score, genres, platforms, sample images).","title":"Detail"}},"title":"list_random_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_platforms":{"post":{"operationId":"list_game_platforms","summary":"List the platforms one game was released on with the first release date for each. Use for \"Which platforms was game 3191","description":"List the platforms one game was released on with the first release date for each. Use for \"Which platforms was game 31910 released on\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"game_id":{"description":"MobyGames numeric game id, for example 31910. Find ids with search_games.","title":"Game Id","type":"integer"}},"required":["game_id"],"title":"list_game_platformsArguments","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_platform_release":{"post":{"operationId":"get_game_platform_release","summary":"Get release details of one game on one platform: attributes, release dates, countries and the companies involved. Use fo","description":"Get release details of one game on one platform: attributes, release dates, countries and the companies involved. Use for \"When and by whom was game 31910 released on platform 5\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"game_id":{"description":"MobyGames numeric game id, for example 31910. Find ids with search_games.","title":"Game Id","type":"integer"},"platform_id":{"description":"MobyGames numeric platform id, for example 5. Find ids with list_game_platforms or list_platforms.","title":"Platform Id","type":"integer"}},"required":["game_id","platform_id"],"title":"get_game_platform_releaseArguments","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_screenshots":{"post":{"operationId":"list_game_screenshots","summary":"List screenshots of one game on one platform with caption, size and image links. Use for \"Show screenshots of game 31910","description":"List screenshots of one game on one platform with caption, size and image links. Use for \"Show screenshots of game 31910 on platform 5\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"game_id":{"description":"MobyGames numeric game id, for example 31910. Find ids with search_games.","title":"Game Id","type":"integer"},"platform_id":{"description":"MobyGames numeric platform id, for example 5. Find ids with list_game_platforms or list_platforms.","title":"Platform Id","type":"integer"}},"required":["game_id","platform_id"],"title":"list_game_screenshotsArguments","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_covers":{"post":{"operationId":"list_game_covers","summary":"List cover art groups of one game on one platform (front, back, media) with image links and the countries they apply to.","description":"List cover art groups of one game on one platform (front, back, media) with image links and the countries they apply to. Use for \"Show the cover art for game 15 on platform 5\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"game_id":{"description":"MobyGames numeric game id, for example 31910. Find ids with search_games.","title":"Game Id","type":"integer"},"platform_id":{"description":"MobyGames numeric platform id, for example 5. Find ids with list_game_platforms or list_platforms.","title":"Platform Id","type":"integer"}},"required":["game_id","platform_id"],"title":"list_game_coversArguments","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}}}}