# Modrinth MCP

> Modrinth connects your AI agent directly to the Modrinth ecosystem. Search, manage, and track Minecraft projects—from mods to plugins—using natural conversation. You can find specific versions, map complex dependencies, view project team members, or check download statistics without leaving your chat client.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** minecraft, modding, open-source, version-control, software-distribution, gaming

## Description

Yo, this isn't some fluff piece of crap. This is your AI agent connecting straight into Modrinth. You can use it to search, track, and manage every single Minecraft mod or plugin project without leaving your chat client.

When you need info on a specific mod, the `search_projects` tool lets you dig through the entire database. You just tell it what you're looking for—whether that’s by keywords, filtering down to a precise game version like 1.20.1, or narrowing it down by loader type like Fabric. If you wanna find specific folks in the community, `search_users` tracks those people down using search queries.

Once you've found a project, you can hit it with `get_project` to pull up full details—the description, the primary download link, and all that metadata. For a deeper dive, `list_versions` gives you every single release available for that mod, listing out both the official status and the unique file hash for each version.

You gotta check dependencies before you run anything, right? Use `get_project_dependencies` to list every other project the mod needs to function. It'll show you exactly what prerequisites you gotta grab. You can also get specific info on a single release with `get_version`, which gives you detailed metadata including compatibility notes.

Need to know who built this thing? The `get_team_members` tool pulls up the names and roles of everyone who contributed to or manages that mod project. If you're curious about the people themselves, you can grab a public profile using `get_user_profile` for any Modrinth user, or see all their published work by running `list_user_projects` on them.

Want to track community interest? You can display a list of users who follow that specific project's page using `list_project_followers`. It’s pure data—you get the info you need right here.

## Tools

### get_project_dependencies
Lists all other projects that a specified mod requires to run correctly.

### get_project
Retrieves full, detailed information about one Modrinth project.

### get_team_members
Fetches the names and roles of people who work on or contribute to a project.

### get_user_profile
Retrieves specific public profile information for any Modrinth user.

### get_version
Gets detailed metadata, including file hashes and compatibility notes, for a single mod version.

### list_project_followers
Displays a list of users who follow a specific project's page.

### list_user_projects
Shows all the projects that a given user has published or contributed to.

### list_versions
Provides a full list of available versions for any project, detailing release dates and status.

### search_projects
Searches the entire Modrinth database by keywords, game version (e.g., 1.20.1), or loader type (Fabric).

### search_users
Finds specific users within the Modrinth community using a search query.

## Prompt Examples

**Prompt:** 
```
Search for optimization mods for Minecraft 1.20.1 using Fabric.
```

**Response:** 
```
I've searched Modrinth and found several optimization mods for Fabric 1.20.1. The top results include 'Sodium' (a modern rendering engine), 'Lithium' (game logic optimization), and 'Indium' (Sodium compatibility layer). Would you like to see the versions available for Sodium?
```

**Prompt:** 
```
Who are the developers of the Sodium mod?
```

**Response:** 
```
The Sodium development team includes several key contributors. The primary authors associated with the project are 'jellysquid3' and members of the CaffeineMC organization. Would you like to see other projects by jellysquid3?
```

**Prompt:** 
```
What does the 'Iris Shaders' mod depend on?
```

**Response:** 
```
I've checked the dependencies for Iris Shaders. It primarily requires 'Sodium' to function. It also has optional dependencies like 'Indium' for better compatibility with other mods. Shall I retrieve the latest version details for Sodium as well?
```

## Capabilities

### Search for mods
You search the Modrinth database, filtering results by game version or loader type.

### Check mod requirements
The agent identifies and lists every required dependency for a given project to function.

### Get project details
You retrieve comprehensive metadata, including the full name, description, and primary download link for any listed mod.

### List versions
The agent provides a chronological list of every released version for a specific project, along with its unique file hash.

### Identify team members
You view the public profiles and roles of people who contributed to or manage a mod.

## Use Cases

### The Server Update Emergency
Your server admin needs to update 'ModX'. Instead of clicking through the mod page and trying to figure out what else it breaks, they tell their agent: 'What does ModX depend on?' The agent runs `get_project_dependencies` and instantly lists all required mods. They know exactly what to check first.

### Developer Vetting
A developer needs to see if a competitor mod uses the same team members they do. They run `list_user_projects` for key individuals and then use `get_team_members` on multiple projects, quickly mapping out who's working where.

### Finding the Right Build
A player wants an optimization mod but needs it specifically for Minecraft 1.20.1 running Fabric. They ask their agent to 'Find mods using Fabric and version 1.20.1.' The agent uses `search_projects` and filters the results instantly.

### Auditing Project History
A user suspects a mod was released incorrectly. They ask their agent for 'The versions of ModY' and run `list_versions`. The tool gives them a full, verifiable history including the release date and unique hash.

## Benefits

- Stop manually checking for compatibility. `get_project_dependencies` automatically identifies every required mod, saving you from runtime errors.
- Never wonder who made a mod again. Use `get_team_members` to see the core contributors and team structure behind any project.
- Need proof of file integrity? Running `get_version` gives you the exact version details and file hashes for audit purposes.
- Find exactly what you need fast. You can use `search_projects`, adding filters like 'Fabric' or '1.20.1', instead of wading through thousands of results.
- Know who's popular? `list_project_followers` gives immediate metrics on a project's community size, without needing to visit the site.

## How It Works

The bottom line is that you talk naturally, and your AI client handles all the complex API lookups for you.

1. Subscribe to this server. You can optionally input your Modrinth Personal Access Token for higher rate limits.
2. Direct your AI client (Claude, Cursor, etc) to the agent and ask a question about Minecraft modding.
3. The agent uses the appropriate tool—like `search_projects` or `get_project_dependencies`—and returns structured data in plain text.

## Frequently Asked Questions

**How do I search for a specific mod using get_project? **
You don't use `get_project` to search. First, run `search_projects` with keywords and the version (e.g., 'Sodium 1.20.1 Fabric'). This returns the project identifier you need for `get_project`.

**Can I use get_project_dependencies to check if my mod is compatible? **
Yes. Running `get_project_dependencies` lists all required mods, which tells you what's needed. It doesn't tell you if it *will* work, but it confirms the technical prerequisites.

**Which tool should I use to find a mod developer? **
Use `get_team_members` on the project page for contributors. If you want to see everything they've ever published, use `list_user_projects` with their username.

**Is list_versions better than get_project for version info? **
`list_versions` gives a full history of every release. Use `get_version` when you need the deep metadata, like file hashes or specific compatibility notes, for one single known version.

**When should I use my Modrinth Personal Access Token with tools like `search_projects`?**
Use the token when you hit rate limits or need continuous, high-volume queries. The token authenticates your agent and increases call capacity for all data retrieval methods.

**How can I list every project associated with a developer using `list_user_projects`?**
This tool returns an array of projects linked to a specific user ID. It's useful when you want to review a creator’s full body of work across the platform.

**What unique details does `get_version` provide compared to just listing versions with `list_versions`?**
`get_version` gives deep metadata for one file, including the exact hash and loader compatibility. This is essential if you need to verify a specific download package.

**Using `get_project`, what core details can I find about a Minecraft mod?**
It provides the project's main description, required loaders, and primary categories. This gives you an immediate overview of the mod without checking versions or dependencies first.

**Is a Personal Access Token (PAT) mandatory to use this server?**
No. Modrinth allows public searching and browsing without a token. However, providing a PAT increases your rate limits and ensures smoother operation during heavy usage.

**Can I check the members of a mod's development team?**
Yes! Use the `get_team_members` tool with the project's slug or ID to see the list of authors and contributors.

**How do I see what other mods a project requires?**
Use the `get_project_dependencies` tool to retrieve a list of all required and optional dependencies for a specific mod or pack.