# Modrinth MCP for AI Agents AI Agent Connect

> Modrinth MCP lets you find and manage Minecraft mods, resource packs, and plugins from your AI agent. It handles project discovery, version tracking, and dependency checking so you don't have to hunt through websites manually.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_AQTQcW54us1dMFrNcCVJNGJo4WEard1RZiVRDLQK/ai-agent-connect
- **Tags:** minecraft, modding, open-source, version-control, software-distribution, gaming

## Description

You're trying to build a specific Minecraft experience, and that means hunting down the right mods, resource packs, and plugins. Instead of opening twenty tabs to check compatibility or searching for the latest versions of a specific loader, you can just ask your AI agent to do the legwork. This Connector connects your agent to the Modrinth ecosystem, letting you pull up project details, check which dependencies are required for a mod to actually run, and see who's actually building the content. If you're a Minecraft host, you can quickly see which mods are trending or check the follower counts to gauge community interest. It's about getting the data you need to build your game environment without the manual clicking. Because Vinkius hosts this Connector, you can plug it into your existing setup and start querying the Modrinth database directly through your chat interface. Whether you're looking for a specific optimization mod for a new version or trying to find the creator of a specific plugin, the information comes straight to you. You get the metadata, the download links, and the team info in one go, so you can spend less time on research and more time actually playing or building.

## Tools

### get_project_dependencies
See what other mods a project needs to run. It helps you avoid broken installations.

### get_project
Get the full details for a specific Modrinth project. It provides a complete overview of the mod or plugin.

### get_team_members
See who is actually working on a project. This is useful for finding contributors or official support.

### get_user_profile
Pull up information on a specific Modrinth user. Use this to find more work from a specific creator.

### get_version
Get the specific details for a single version of a project. It gives you the exact metadata for a download.

### list_project_followers
See how many people are following a project. This helps you gauge the popularity of a mod.

### list_user_projects
See every project a specific user has published. This is great for finding more content from a favorite author.

### list_versions
Get a full list of all available versions for a project. It helps you find the right release for your game version.

### search_projects
Search for Minecraft projects using filters like game version or loader. This is the primary way to find new content.

### search_users
Find specific users on the Modrinth platform. Use this to locate creators or community members.

## Prompt Examples

**Prompt:** 
```
Find some high-performance mods for Minecraft 1.20.1 on Fabric.
```

**Response:** 
```
I've found several high-performance mods for Minecraft 1.20.1 using the Fabric loader. Here are the top results:

| Mod Name | Description | Key Features |
| :--- | :--- | :--- |
| **Sodium** | Modern rendering engine | Significant FPS boost |
| **Lithium** | Game logic optimization | Better CPU usage |
| **Indium** | Sodium compatibility | Fixes block models |

Would you like me to check the version history for any of these?
```

**Prompt:** 
```
Who is the lead dev for the Sodium mod and what else have they made?
```

**Response:** 
```
The primary authors associated with the Sodium project are **jellysquid3** and members of the **CaffeineMC** organization.

Here are other projects by **jellysquid3**:
*   *Project A* (Optimization)
*   *Project B* (Utility)

Would you like to see the team members for Sodium as well?
```

**Prompt:** 
```
Does the Iris Shaders mod need anything else to run?
```

**Response:** 
```
I've checked the dependencies for the Iris Shaders mod. It requires the following to function correctly:

*   **Sodium** (Required)
*   **Indium** (Optional, for better compatibility with other mods)

I can also pull up the latest version details for Sodium if you'd like.
```

## Capabilities

### Find specific Minecraft projects
Search for mods by game version, loader, or category.

### Track mod versions
Get download links and metadata for specific project releases.

### Check mod dependencies
See which other projects a mod needs to work properly.

### View creator profiles
Look up public profiles and team members for any project.

### Monitor community stats
See follower counts and download metrics for various projects.

### Get file details
Access hashes and loader compatibility for specific versions.

## Use Cases

### Finding performance mods
A player wants to find optimization mods for Minecraft 1.20.1 on Fabric. They ask their agent to search_projects for the best options.

### Checking plugin requirements
A host needs to know what a specific plugin requires to function. They use get_project_dependencies to see the full list of needs.

### Discovering creator content
A user finds a mod they love and wants to see what else that person has made. They use list_user_projects to see the full portfolio.

### Verifying version metadata
A developer needs the exact file hash and loader info for a specific release. They use get_version to pull that metadata instantly.

## Benefits

- Stop manual searching: Use search_projects to find mods by loader or version instantly without opening a browser.
- Avoid broken installs: Check requirements with get_project_dependencies to see exactly what else you need to download.
- Track updates easily: Use list_versions to see every release and find the right one for your current game setup.
- Research creators: Use list_user_projects and get_user_profile to discover more content from your favorite modders.
- Monitor popularity: Use list_project_followers to see which mods are gaining traction in the community.
- Get technical specs: Use get_version to pull specific hashes and loader compatibility details for your builds.

## How It Works

The bottom line is you get direct access to the Modrinth database through your AI agent without leaving your workspace.

1. Subscribe to the Modrinth MCP on Vinkius
2. Add your Modrinth Personal Access Token if you need higher rate limits
3. Ask your AI client to find mods or check project details

## Frequently Asked Questions

**Can the Modrinth MCP find mods for specific game versions?**
Yes, it can filter the Modrinth database by specific game versions like 1.20.1 to ensure you only see mods that work for your setup.

**How does the Modrinth MCP help with Minecraft host dependencies?**
It identifies exactly which other mods or plugins a project requires to run, helping you avoid broken installations and crashes.

**Can I use the Modrinth MCP to find resource packs?**
Yes, the search tools cover all project types on the platform, including mods, resource packs, and plugins.

**Does the Modrinth MCP show me who made a mod?**
It can pull up public user profiles and list the specific team members associated with any project on Modrinth.

**Can I see the latest version of a mod with the Modrinth MCP?**
Yes, it can list every available version of a project so you can find the most recent release or a specific older one.

**Is the Modrinth MCP good for finding trending mods?**
It can show you follower counts and other community metrics, making it easy to see which projects are currently popular.

**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.