Nexus Mods MCP server - 140 tools over REST API v1 + GraphQL API v2
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"nexus-mods-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# nexus-mcp [](LICENSE) [](pyproject.toml) [](https://github.com/Talya1412/nexus-mcp/actions/workflows/ci.yml) [](https://pypi.org/project/nexus-mods-mcp/) [](https://modelcontextprotocol.io) **140 MCP tools** for [Nexus Mods](https://www.nexusmods.com) — wraps the official **REST API v1** and **GraphQL API v2** as a Model Context Protocol server (Python + FastMCP, stdio transport). Lets any MCP client (Claude Desktop, opencode, Cursor, ...) browse games, inspect mods and files, run free-text searches, download mod files with checksum verification, manage endorsements, comments, collections, and user preferences. ## Highlights - **Full API coverage** — 74 read tools + 66 mutations across v1 REST and v2 GraphQL. Includes things v1 doesn't offer: free-text mod search, batch mod lookups, comment threads, collection lifecycle, and quota-free GraphQL reads. - **Built-in TTL cache** — repeated identical GETs within a session don't consume quota (games 1h, mod/file data 5 min, GraphQL POSTs 60 s). Personal state (`/user/*`) is never cached. - **Dual authentication** — personal API key out of the box; optional OAuth2 (PKCE S256) with auto-refresh for user-context mutations that API keys cannot perform. - **Safe downloads** — `nexus_download_mod_file` streams from the CDN to disk, verifies MD5 + SHA-256 checksums against the expected hashes, and enforces a configurable size cap. - **Rate-limit transparency** — every v1 response carries an `_rl` snapshot of Nexus' hourly/daily limit headers. ## Install ```bash # uv (recommended for MCP servers) uvx --from nexus-mods-mcp nexus-mcp # pipx pipx install nexus-mod…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.