modrinth-mcp
An MCP server that allows agents to search the Modrinth platform and manage Minecraft mod projects. It supports reading project metadata, listing versions, creating new projects as drafts, and uploading new versions with jar files. It interacts with the Modrinth API, requiring a Personal Access Token for write operations.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
Checks and signals
Each line is separate evidence, not a trust score.
- Popularity 1 GitHub star
What you can do with it
- Search for Minecraft mods on Modrinth
- Create a new mod project as a draft
- Upload and publish new mod versions
- List published versions of a project
Source and maintenance
- Last repository push
- Latest release
- v0.1.2
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
@justinscott12/modrinth-mcp 0.1.1
{
"version": "0.1.1",
"transport": "stdio",
"identifier": "@justinscott12/modrinth-mcp",
"registryType": "npm",
"environmentVariables": [
{
"name": "MODRINTH_TOKEN",
"format": "string",
"description": "Modrinth Personal Access Token (https://modrinth.com/settings/pats). Required only for write actions; read-only tools work without it."
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · repository · passed · metadata changed · updated
- · backfill · recorded · Pre-expansion baseline; unobserved rich metadata remains unknown
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"modrinth-mcp-justinscott12-modrinth-mcp": {
"command": "npx",
"args": [
"-y",
"@justinscott12/modrinth-mcp@0.1.1"
],
"env": {
"MODRINTH_TOKEN": "<YOUR_MODRINTH_TOKEN>"
}
}
}
}Cline
{
"mcpServers": {
"modrinth-mcp-justinscott12-modrinth-mcp": {
"command": "npx",
"args": [
"-y",
"@justinscott12/modrinth-mcp@0.1.1"
],
"env": {
"MODRINTH_TOKEN": "<YOUR_MODRINTH_TOKEN>"
}
}
}
}VS Code
{
"servers": {
"modrinth-mcp-justinscott12-modrinth-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@justinscott12/modrinth-mcp@0.1.1"
],
"env": {
"MODRINTH_TOKEN": "<YOUR_MODRINTH_TOKEN>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"modrinth-mcp-justinscott12-modrinth-mcp": {
"command": "npx",
"args": [
"-y",
"@justinscott12/modrinth-mcp@0.1.1"
],
"env": {
"MODRINTH_TOKEN": "<YOUR_MODRINTH_TOKEN>"
}
}
}
}Let your agent find its tools
Find servers like modrinth-mcp from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.