Modrinth MCP. Map dependencies and track mod versions instantly.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
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.
What your AI agents can do
Get project
Retrieves full, detailed information about one Modrinth project.
Get project dependencies
Lists all other projects that a specified mod requires to run correctly.
Get team members
Fetches the names and roles of people who work on or contribute to a project.
You search the Modrinth database, filtering results by game version or loader type.
The agent identifies and lists every required dependency for a given project to function.
You retrieve comprehensive metadata, including the full name, description, and primary download link for any listed mod.
The agent provides a chronological list of every released version for a specific project, along with its unique file hash.
You view the public profiles and roles of people who contributed to or manage a mod.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Modrinth MCP Server: 10 Tools for Project Data
Use these tools to search, filter, and retrieve structured data about Minecraft mods, user profiles, and project dependencies.
019d75d7get project
Retrieves full, detailed information about one Modrinth project.
019d75d7get project dependencies
Lists all other projects that a specified mod requires to run correctly.
019d75d7get team members
Fetches the names and roles of people who work on or contribute to a project.
019d75d7get user profile
Retrieves specific public profile information for any Modrinth user.
019d75d7get version
Gets detailed metadata, including file hashes and compatibility notes, for a single mod version.
019d75d7list project followers
Displays a list of users who follow a specific project's page.
019d75d7list user projects
Shows all the projects that a given user has published or contributed to.
019d75d7list versions
Provides a full list of available versions for any project, detailing release dates and status.
019d75d7search projects
Searches the entire Modrinth database by keywords, game version (e.g., 1.20.1), or loader type (Fabric).
019d75d7search users
Finds specific users within the Modrinth community using a search query.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Modrinth, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
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.
How Modrinth MCP Works
- 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_projectsorget_project_dependencies—and returns structured data in plain text.
The bottom line is that you talk naturally, and your AI client handles all the complex API lookups for you.
Who Is Modrinth MCP For?
This is for anyone who spends time with Minecraft modding or running dedicated servers. If you're the server admin stuck in a web browser clicking through update logs, or the developer trying to map out complex software dependencies, this saves hours of manual research.
You check if your installed plugins have updated dependencies or need version compatibility checks before a major server restart.
You inspect competitor project metadata, user profiles, and version histories to see how other popular mods are structured.
You quickly find the latest optimization or content mod for a specific Minecraft version without having to navigate multiple websites.
What Changes When You Connect
- Stop manually checking for compatibility.
get_project_dependenciesautomatically identifies every required mod, saving you from runtime errors. - Never wonder who made a mod again. Use
get_team_membersto see the core contributors and team structure behind any project. - Need proof of file integrity? Running
get_versiongives 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_followersgives immediate metrics on a project's community size, without needing to visit the site.
Real-World 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.
The Tradeoffs
Hardcoding IDs
Telling your agent to check 'Mod ID 1234' when you only know the name. This fails because the ID might change, or it might be invalid.
→
Always start by using search_projects with keywords like the mod name and version. Once the search returns the correct project, use that resulting identifier for specific calls like get_project.
Ignoring Dependencies
Trying to download a large content mod without first checking its requirements leads to crashes or broken features.
→
Before getting any project details, run get_project_dependencies. This step is mandatory for ensuring the entire mod stack works together.
Mixing up User/Project Data
Asking 'What mods does this user make?' when you actually mean 'What mods are popular right now?'
→
If you want popularity, run list_project_followers. If you want to know what a specific person contributes, use list_user_projects.
When It Fits, When It Doesn't
Use this server if your task involves the structured discovery or deep metadata analysis of Minecraft mods. Specifically: Do you need to check dependencies (get_project_dependencies), validate file versions (get_version), or compare user profiles (get_user_profile)? If the answer is yes, use Modrinth.
Don't use this if you just want a general list of all Minecraft games. Use a simple search engine for that. Also, don't rely on it for current news or community chat; it only handles structured data retrieval. When in doubt about whether a tool exists, start with search_projects to narrow your focus.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Modrinth. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Figuring out what mods work together shouldn't involve 15 browser tabs.
Before MCP, figuring out a mod stack was tedious. You found Mod A on Site X. Then you had to click through its documentation to see if it needed Mod B. If so, you opened Site Y for Mod B, and then maybe a third site just to check the compatibility of Mod C—all while copy-pasting version numbers and hoping nothing broke.
Now, your AI client handles the whole process. You ask: 'What mods are optimized for Fabric 1.20.1?' The agent runs `search_projects` and then uses `get_project_dependencies` to map out every single required component in one go. You get a clean list of working components.
Modrinth MCP Server: Instantly track versions and team details.
Manual checks involve logging into multiple developer dashboards, searching for version numbers in text files, and cross-referencing who claimed ownership of the project. This process is slow, error-prone, and requires deep knowledge of API endpoints.
With this server, you simply ask: 'Show me all versions of ModZ' or 'Who runs ProjectY?' The agent executes `list_versions` or `get_team_members`, giving you the precise, structured data you need—no manual effort required.
Common Questions About Modrinth MCP
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Strapi
Connect your AI to Strapi. Fully orchestrate your headless CMS — create entries, manage content types, and upload media assets naturally.
Unleash (Feature Toggles)
Manage feature flags, strategies, and environments via Unleash — evaluate toggles, list projects, and monitor metrics directly from your AI agent.
Payload CMS Extended
Manage your Payload CMS instance — query collections, inspect documents, and manage content directly from your AI agent.
You might also like
VolunteerHub
Coordinate volunteers with event sign-ups, hour tracking, and communication tools built for nonprofits and community organizations.
Hugging Face
Explore AI models, datasets and Spaces via Hugging Face — search models, inspect files, review discussions and track collections from any AI agent.
Chewy Ads
Manage retail media and sponsored products via Chewy Ads — track campaigns, monitor performance, and audit keywords directly from any AI agent.