Validate NEXUS_API_KEY and show the account (name, premium/supporter) plus remaining API rate limit.

Game details by domain name: id, name, mod/file/download counts, categories (id → name). Use list_games to discover domain names.

Full mod info: name, version, author, status, downloads, endorsements, dates, summary, your endorsement status.

List a mod's files (file_id, name, version, category, size, upload date). Optional category filter.

Details for one mod file.

All version changelogs of a mod (version → entries). Newest versions last.

10 mods per list: latest_added, latest_updated or trending for a game.

IDs of mods updated in the last day/week/month (with timestamps). Use to check tracked mods for updates.

Identify a mod file from its MD5 hash (returns mod + file). For a batch of hashes use graphql_query with fileHashes.

CDN download URLs for a file. Premium: works directly. Non-premium: pass key + expires from an nxm:// link (nxm:///mods//files/?key=...&expires=...).

Download a mod file to a local directory (dest_dir, else NEXUS_DOWNLOAD_DIR). Premium: direct. Non-premium: pass key + expires from an nxm:// link.

Mods you track (game domain + mod id). Optional game filter.

Start or stop tracking a mod.

Endorse a mod or abstain from endorsing. The current mod version is looked up automatically if not given.

Mods you endorsed or abstained from.

Search mods by name (wildcard), optionally within one game, sorted. No API key needed. Returns game/modId pairs usable by every other tool.

Find games and their domain names (needed by all game-scoped tools). No API key needed.

Mod info without an API key, including the full description (BBCode as stored), tags, uid (for v3), requirements and mods requiring it.

Search collections by name / game. Returns slugs for get_collection and get_collection_comments.

Collection details by slug: author, stats, comment thread id, latest revision and (optionally) its mod list.

Read a collection's comments (newest first) with first replies. Pass comment_thread_id (from get_collection) or slug. Paginate with after = endCursor. Write via post_collection_comment (web tier).

Public profile by username: member id, join date, kudos, mod/collection counts, about.

Latest Nexus Mods news, optionally per game/category.

Run any read-only query against https://api.nexusmods.com/v2/graphql (schema: https://graphql.nexusmods.com/). Mutations are rejected. Output is raw JSON — prefer the typed tools.

Resolve a mod (game + mod_id from the site URL) to its v3 mod uid and list its mod files (v3 mod_file ids) — the ids upload_file_version and add_changelog need.

Versions of one v3 mod file (id, version, category, upload date, primary).

Upload a local archive as a NEW VERSION of an existing mod file and publish it immediately (multipart upload → finalise → wait → publish). Get mod_file_id from get_upload_targets. If publishing fails after the upload, retry with upload_id to skip re-uploading. Optionally adds a changelog (needs mod_uid).

Add changelog text for a version of a mod. mod_uid from get_upload_targets.

Check whether the browser session is logged in to nexusmods.com (needed only for web-tier WRITE tools).

Get a nexusmods.com session: extracts cookies from installed browsers, else opens a visible sign-in window (session captured automatically, persists across runs). Re-run your action after signing in.

Manually set nexusmods.com cookies: a Cookie header string "name1=value1; name2=value2" from a logged-in browser.

Read a mod page's Posts tab: threaded comments (id, author, date, text, inline replies), sticky first. 10 threads per page. Works without login.

Post a comment on a mod's Posts tab, or reply to a comment (parent_id from get_mod_comments). Needs a logged-in web session. BBCode allowed.

Edit your own comment on a mod's Posts tab (comment_id from get_mod_comments). Needs a logged-in web session.

Comment on a collection (comment_thread_id from get_collection), or reply (reply_to_id). Uses the site's CreateComment mutation with the web session.

Edit your collection comment (UpdateComment mutation via web session).

Delete (discard) your collection comment (DiscardComment mutation via web session). Cannot be undone.

List sub-forums and topics of a forum (forum_id or URL), or the forum index when omitted. Topics: id, title, author, date, replies, views. Works without login.

Read posts of a forum topic (topic id or URL), 25 per page. Works without login.

Post a reply in a forum topic (id or URL). Needs a logged-in web session (forum sign-in is done automatically via SSO).

List your private-message conversations (forum messenger): id, title, participants, last message snippet, unread flag. Needs a logged-in web session.

Read the messages of a private conversation (id from pm_list), 25 per page. Needs a logged-in web session.

Start a new private conversation with one or more members (forum messenger compose). Needs a logged-in web session.

Reply in an existing private conversation (id from pm_list). Needs a logged-in web session.

Leave a private conversation — removes it from your inbox (the conversation is deleted once no participants remain). Uses the conversation page's 'leave' link.

List a mod's bug reports (Bugs tab): id, title, status, replies, version, priority, last post. 10 per page. Works without login (private reports need the author's session).

Read one bug report and its replies (issue_id from get_mod_bugs).

File a new bug report on a mod (Bugs tab → Report a bug). BBCode allowed. Needs a logged-in web session.

Reply to a bug report (issue_id from get_mod_bugs). BBCode allowed. Needs a logged-in web session.

Delete a bug report and all its replies from YOUR mod (mod author/moderator only). Cannot be undone.

Hide a comment on a mod's Posts tab — the site's 'Hide and optionally report post' action (removes it from view for everyone except staff). Available to the mod's author for any comment on their mod. Needs a logged-in web session.

List a mod's author images (id, url, title, primary/thumbnail) and videos as the mod editor shows them. Author/editor session required.

Upload an image (JPG/PNG/GIF, max 8 MB) to YOUR mod's gallery, as the mod editor does: image safety hash check, upload, media cache refresh. Needs the author's web session.

Delete an image from YOUR mod's gallery (image_id from get_mod_media). Cannot be undone.

Add a YouTube video to YOUR mod's Videos tab, as the mod editor does. Needs the author's web session.

Delete a video from YOUR mod (video_id from add_mod_video / get_mod_media). Cannot be undone.

Edit YOUR mod page's name, summary, full description (BBCode) and/or version, as the mod editor's Save does. Unchanged fields (category, author, tags, translation) are resent exactly as loaded. Omit all edit fields to just view the current values. Use dry_run to preview the request.