{"openapi":"3.1.0","info":{"title":"Nexus Mods (BYOK) API","version":"0.1.0","description":"Nexus Mods (BYOK) lets an AI assistant read your own Nexus Mods data through the Nexus Mods API with a key you supply (Nexus Mods personal API key). Read-only: 9 tools (list_games, get_game, get_trending_mods, get_latest_added_mods, get_latest_updated_mods, list_updated_mods, get_mod, list_mod_files, get_mod_changelogs). The BYOK key travels with each request, is used for that one call only and...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-nexusmods.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-nexusmods/docs"},"termsOfService":"https://connectorbay.com/byok-nexusmods/terms"},"servers":[{"url":"https://byok-nexusmods.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-nexusmods/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_games":{"post":{"operationId":"list_games","summary":"List the games supported by Nexus Mods with domain name, download and mod counts. The OpenAPI file does not list respons","description":"List the games supported by Nexus Mods with domain name, download and mod counts. The OpenAPI file does not list response fields, so the answer is passed through (capped). Use for \"Which games does Nexus Mods cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"include_unapproved":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include games that are not yet approved.","title":"Include Unapproved"}},"title":"list_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 with its mod, file and download counts and mod categories. The OpenAPI file does not list response fields, ","description":"Get one game with its mod, file and download counts and mod categories. The OpenAPI file does not list response fields, so the answer is passed through (capped). Use for \"How many mods does Nexus Mods have for Skyrim Special Edition\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"game_domain_name":{"description":"Game domain name as used in Nexus Mods URLs, for example 'skyrimspecialedition' or 'fallout4' (see list_games).","maxLength":60,"title":"Game Domain Name","type":"string"}},"required":["game_domain_name"],"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/get_trending_mods":{"post":{"operationId":"get_trending_mods","summary":"Get the 10 trending mods of a game. The OpenAPI file does not list response fields, so the answer is passed through (cap","description":"Get the 10 trending mods of a game. The OpenAPI file does not list response fields, so the answer is passed through (capped). Use for \"What mods are trending for Skyrim Special Edition on Nexus Mods\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"game_domain_name":{"description":"Game domain name as used in Nexus Mods URLs, for example 'skyrimspecialedition' or 'fallout4' (see list_games).","maxLength":60,"title":"Game Domain Name","type":"string"}},"required":["game_domain_name"],"title":"get_trending_modsArguments","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_latest_added_mods":{"post":{"operationId":"get_latest_added_mods","summary":"Get the 10 mods most recently added for a game. The OpenAPI file does not list response fields, so the answer is passed ","description":"Get the 10 mods most recently added for a game. The OpenAPI file does not list response fields, so the answer is passed through (capped). Use for \"What are the newest mods for Fallout 4 on Nexus Mods\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"game_domain_name":{"description":"Game domain name as used in Nexus Mods URLs, for example 'skyrimspecialedition' or 'fallout4' (see list_games).","maxLength":60,"title":"Game Domain Name","type":"string"}},"required":["game_domain_name"],"title":"get_latest_added_modsArguments","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_latest_updated_mods":{"post":{"operationId":"get_latest_updated_mods","summary":"Get the 10 mods most recently updated for a game. The OpenAPI file does not list response fields, so the answer is passe","description":"Get the 10 mods most recently updated for a game. The OpenAPI file does not list response fields, so the answer is passed through (capped). Use for \"Which Fallout 4 mods were updated most recently on Nexus Mods\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"game_domain_name":{"description":"Game domain name as used in Nexus Mods URLs, for example 'skyrimspecialedition' or 'fallout4' (see list_games).","maxLength":60,"title":"Game Domain Name","type":"string"}},"required":["game_domain_name"],"title":"get_latest_updated_modsArguments","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_updated_mods":{"post":{"operationId":"list_updated_mods","summary":"List the IDs and last update times of all mods updated for a game in the last day, week or month. The OpenAPI file does ","description":"List the IDs and last update times of all mods updated for a game in the last day, week or month. The OpenAPI file does not list response fields, so the answer is passed through (capped). Use for \"Which Skyrim Special Edition mods changed in the last week\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"game_domain_name":{"description":"Game domain name as used in Nexus Mods URLs, for example 'skyrimspecialedition' or 'fallout4' (see list_games).","maxLength":60,"title":"Game Domain Name","type":"string"},"period":{"description":"Time window: 1d, 1w or 1m.","enum":["1d","1w","1m"],"title":"Period","type":"string"}},"required":["game_domain_name","period"],"title":"list_updated_modsArguments","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_mod":{"post":{"operationId":"get_mod","summary":"Get one mod: name, summary, description, author, version, endorsements, downloads and dates. The OpenAPI file does not l","description":"Get one mod: name, summary, description, author, version, endorsements, downloads and dates. The OpenAPI file does not list response fields, so the answer is passed through (capped). Use for \"Tell me about Nexus Mods mod 1234 for Skyrim Special Edition\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"game_domain_name":{"description":"Game domain name as used in Nexus Mods URLs, for example 'skyrimspecialedition' or 'fallout4' (see list_games).","maxLength":60,"title":"Game Domain Name","type":"string"},"mod_id":{"description":"Nexus Mods mod ID (a number from the mod page URL).","minimum":1,"title":"Mod Id","type":"integer"}},"required":["game_domain_name","mod_id"],"title":"get_modArguments","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_mod_files":{"post":{"operationId":"list_mod_files","summary":"List the files of a mod, optionally by category (main, update, optional, old_version, miscellaneous). The OpenAPI file d","description":"List the files of a mod, optionally by category (main, update, optional, old_version, miscellaneous). The OpenAPI file does not list response fields, so the answer is passed through (capped). Use for \"What files does Nexus Mods mod 1234 have for Skyrim Special Edition\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"game_domain_name":{"description":"Game domain name as used in Nexus Mods URLs, for example 'skyrimspecialedition' or 'fallout4' (see list_games).","maxLength":60,"title":"Game Domain Name","type":"string"},"mod_id":{"description":"Nexus Mods mod ID (a number from the mod page URL).","minimum":1,"title":"Mod Id","type":"integer"},"category":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated file categories, case-insensitive: main, update, optional, old_version, miscellaneous.","title":"Category"}},"required":["game_domain_name","mod_id"],"title":"list_mod_filesArguments","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_mod_changelogs":{"post":{"operationId":"get_mod_changelogs","summary":"Get the changelog entries of a mod, keyed by version. The OpenAPI file does not list response fields, so the answer is p","description":"Get the changelog entries of a mod, keyed by version. The OpenAPI file does not list response fields, so the answer is passed through (capped). Use for \"What changed between versions of Nexus Mods mod 1234\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"game_domain_name":{"description":"Game domain name as used in Nexus Mods URLs, for example 'skyrimspecialedition' or 'fallout4' (see list_games).","maxLength":60,"title":"Game Domain Name","type":"string"},"mod_id":{"description":"Nexus Mods mod ID (a number from the mod page URL).","minimum":1,"title":"Mod Id","type":"integer"}},"required":["game_domain_name","mod_id"],"title":"get_mod_changelogsArguments","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}}}}