Official description7 sourcesMCP servers8d ago

justinscott12/modrinth-mcp

MCP server for searching Modrinth and publishing Minecraft mods via the Modrinth API. npm package + Claude Code plugin.

View on GitHub ↗Direct link · no redirect page

Config template (adjust for your client)

claude mcp add modrinth-mcp -- npx -y modrinth-mcp

A pasteable skeleton generated from the repository name. Check the project README for the exact package and arguments.

Star count: 0 ★ · justinscott12/modrinth-mcp · read from the repository page · (checked 2026-10-16 20:00:20)
Source: collected from the punkpeye/awesome-mcp-servers list · type: MCP server
Harvest history: first seen 2026-10-09 · last seen 2026-10-16 · seen 32× · listed by 7 sources
Score: score 703 · 7 sources · mcp

FAQ (answers come from our records)

How do I install it?

We did not find an install command for this repository (our install coverage is only about 4%). Check its README or releases page.

Who is it for?

We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.

Who maintains it?

repository justinscott12/modrinth-mcp；first catalogued 2026-10-09；last seen 2026-10-16。There is no official certification or quality rating here — we record sources and dates only.

Third-party quality signals

modrinth-mcp

以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →

An MCP server that wraps the Modrinth API so an AI agent (Claude Code, Claude Desktop, Cursor, …) can search projects, read project/version metadata, and **publish Minecraft mods** — create projects and upload built jars as new versions.
Tools
| Tool | Auth | What it does |
| --- | --- | --- |
| modrinth_whoami | ✅ | Verify your token; return the authenticated user. |
| modrinth_search_projects | – | Search public Modrinth projects. |
| modrinth_get_project | – | Get a project's metadata by slug or id. |
| modrinth_list_project_versions | – | List a project's published versions. |
| modrinth_create_version | ✅ | Publish a **new version** by uploading one or more jars. |
| modrinth_create_project | ✅ | Create a **new project** (as a draft). |
| modrinth_modify_version | ✅ | Edit metadata of an existing version. |
Read-only tools work without a token. Anything that writes needs a Modrinth **Personal Access Token**.
Getting a token
Create a PAT at with these scopes:
- Read projects
- Read versions
- Create versions
- Write versions
Set it as the MODRINTH_TOKEN environment variable.
Install
As a Claude Code plugin
It runs the published npm package under the hood via npx. Claude Code
plugins have no token-entry UI, so the server reads its token from the
MODRINTH_TOKEN **environment variable** in the environment Claude Code
runs in. Set it before launching Claude Code, e.g.:
Then restart Claude Code and run modrinth_whoami to confirm. Read-only
tools (search, get project/versions) work without a token.
As an MCP server (any client)
Add to your MCP client config (e.g. Claude Desktop claude_desktop_config.json):
Or in Claude Code directly:
Environment variables
| Variable | Default | Purpose |
| --- | --- | --- |
| MODRINTH_TOKEN | – | Modrinth Personal Access Token. Required for write actions. |
| MODRINTH_STAGING | unset | Set to 1 to hit https://staging-api.modrinth.com for safe testing. |
| MODRINTH_USER_AGENT | modrinth-mcp/ … | Override the User-Agent sent to Modrinth. |
Example flow
1. modrinth_whoami — confirm auth works.
2. modrinth_create_project — create the project page (created as a draft).