CurseForge MCP for AI. Manage Mod Files and Game Versions Instantly
Works with every AI agent you already use
…and any MCP-compatible client








Connect to your AI in seconds.
CurseForge MCP lets your agent navigate the world's largest repository of gaming mods. Search for projects across Minecraft, WoW, and more; fetch detailed metadata, full descriptions, and secure download links for mod files automatically.
What your AI can do
List categories
Lists all available mod categories for an entire game title.
Get files batch
Retrieves a list of files based on provided IDs.
Get fingerprints matches fuzzy
Performs a less strict, fuzzy match when identifying unknown mods from local files.
Find specific game modifications by filtering criteria like category, version, and text search.
Get complete mod information, including full descriptions, author data, and lists of available files.
Generate direct, signed URLs for specific mod files so you can download them without complex setup.
Identify known mods by running local file fingerprints against the CurseForge database.
List all supported games, available version types, and mod categories for any given game ID.
Ask an AI about this
Waiting for input…
CurseForge: 17 Available Tools
These tools let your agent interact with every part of the modding ecosystem—from listing available games to retrieving individual file versions.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using CurseForge on VinkiusList Categories
Lists all available mod categories for an entire game title.
Get Files Batch
Retrieves a list of files based on provided IDs.
Get Fingerprints Matches Fuzzy
Performs a less strict, fuzzy match when identifying unknown mods from local files.
Get Fingerprints Matches
Compares local file fingerprints against the database to identify matching mods.
Get Game
Gets core details about one specific game title.
List Games
Lists every game available through this API key.
Get Mod Description
Retrieves the full HTML description used by the mod author.
Get Mod File Changelog
Retrieves the HTML changelog for a particular mod file version.
Get Mod File Download Url
Creates a signed, temporary URL allowing direct download of a specific mod file.
Get Mod File
Gets specific details about a file associated with a mod.
List Mod Files
Retrieves all files associated with a specific mod ID.
Get Mod
Fetches the main metadata and general information for a single mod ID.
Get Mods Batch
Gets a list of multiple mods when you only have their IDs.
Search Mods
Finds mods across the platform using detailed text, category, or version filters.
List Game Version Types
Shows what kinds of version types are supported by a game (e.g., Beta, Release).
List Game Versions V1
Retrieves all available versions for a game using the V1 format.
List Game Versions V2
Gets detailed version information for a game using the V2 format.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
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 CurseForge, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ 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
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by CurseForge. 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 connection provides 17 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
The manual headache of tracking game assets
Right now, checking mod compatibility means opening multiple tabs. You search for the mod on one site, then open another to find its file versions, and a third to read the changelog. You copy version numbers into spreadsheets just to keep track of what works with what.
With this MCP, your agent handles that whole cycle. It finds all relevant mods, pulls down their complete metadata, and figures out the necessary links for you—all without leaving your chat interface.
Get Mod File Download Links with `get_mod_file_download_url`
The biggest pain point is getting a file. You find the right mod and version, but you can't just download it; there are access restrictions or temporary links needed. Manual downloading means jumping through hoops.
Now, your agent uses `get_mod_file_download_url` to instantly generate a secure link that works. It handles the complexity of file signing so you get exactly what you need, right when you need it.
What your AI can actually do with this
This connector gives your AI client deep access to the massive library of game modifications. Whether you’re a modder tracking version changes or an admin needing to verify file integrity, you don't have to click through dozens of web pages just to find what you need. You can search for mods using filters like category or version ID, and then pull complete descriptions and developer notes instantly.
It goes deeper than simple searching; your agent pulls the actual files, including changelogs, and generates signed download links so you don't have to worry about manual retrieval. When you connect this MCP via Vinkius, it becomes a reliable data source, letting you focus on building mods instead of managing API keys or web scraping.
019e5d0f-576e-70d3-8bea-fe5057cc2f4a Here's how it actually works
The bottom line is that this MCP turns a huge, complicated website into a simple set of commands for your AI client.
Subscribe to the MCP and provide your CurseForge API key.
Tell your agent what you need—for instance, 'Find all files for Mod X from Game Y.'
Your agent executes the necessary calls, retrieving structured data (like file lists or download URLs) and presenting it directly in your chat.
Who is this actually for?
Anyone who deals with large-scale digital content or complex versioning systems. This is for the game developer who can't afford to manually check every file, or the technical writer who needs perfect documentation on a specific mod feature.
Checks if local assets match known mods using fingerprint matching and fetches the latest files needed for a server build.
Pulls full mod descriptions, changelogs, and version history to write accurate guides without leaving their documentation tool.
Automates the process of checking for required updates and gathering download links for entire server packs across multiple game versions.
What Changes When You Connect
You don't have to guess which files exist. Instead, you can list all mod files for a given ID using list_mod_files, guaranteeing you see every asset.
When you find an unknown mod file on your local machine, running the get_fingerprints_matches tool instantly tells you what it is and where it came from.
Need to write about version history? The MCP lets you get the full changelog for a specific file using get_mod_file_changelog, so your documentation is always current.
Forget complicated download procedures. Using get_mod_file_download_url provides a secure, signed link right when you need it.
Instead of searching page by page, the search_mods tool lets you pinpoint exactly what you want using criteria like game ID or specific version number.
See it in action
Tracking a Patch Update
A server admin needs to confirm that all clients are running the correct build. They ask their agent to list available versions for the target game using list_game_versions_v2, then use get_mods_batch to pull details on the top three required mods, ensuring no version gaps exist.
Identifying a Custom Mod
A developer finds an old mod file but doesn't know its origin. They run their local files through get_fingerprints_matches to identify the exact source and confirm if it’s still supported.
Writing a Feature Summary
A technical writer needs to summarize a mod's history for a guide. They use get_mod to get basic details, then call get_mod_file_changelog repeatedly for the latest file version to build out an accurate timeline.
Building a Mod Manager API
A tool developer builds a new application that needs stable links. They use list_games first, then iterate through the available versions using list_game_versions_v1 before requesting final download URLs via get_mod_file_download_url.
The honest tradeoffs
Searching by general text
Asking the agent to 'find a mod about combat' without providing any game ID or category. The results are too broad and useless.
Start by using list_games to narrow down the ecosystem, then use search_mods with specific criteria (e.g., Game ID + Category: Combat) for precise results.
Missing file context
Trying to get a download link without knowing which mod and version it belongs to. You just get an error.
Always use get_mod first to confirm the mod details, then retrieve the specific files using list_mod_files before requesting the final URL via get_mod_file_download_url.
Assuming single endpoint
Thinking there's one 'Get Mod Data' button that handles everything. It doesn't.
Understand the workflow: use get_mod for general details, but if you need the file or history, you must call specialized tools like get_mod_file and get_mod_file_changelog.
When It Fits, When It Doesn't
Use this MCP if your task involves structured discovery of gaming assets, version tracking, or retrieving specific files from a known catalog. You need it when you're moving beyond simple chat conversation and require actionable data like download URLs or detailed metadata.
Don't use it if you are trying to scrape unstructured web content (like articles about mods), or if your goal is general community discussion. For those, you need a different kind of connector—something designed for broad text scraping rather than structured API calls. If you only need to know if a mod exists, search_mods is fine. But if you need the actual file details, stick to the specific tools like get_mod_file and list_mod_files.
Questions you might have
How do I find mods using `search_mods`? +
You provide key search terms along with filters like category or game ID. For example, 'Find all tech mods for Minecraft version 1.20.' The tool handles the filtering automatically.
What is the best way to check if a local mod file is legitimate? Use `get_fingerprints_matches`? +
Yes, that's exactly right. Running get_fingerprints_matches compares your file's unique signature against the official database, confirming its origin and status.
How do I get a complete picture of all files for one mod? Should I use `list_mod_files`? +
Yes. list_mod_files shows everything associated with that specific mod ID, giving you the full scope of available assets.
Can I get a changelog for an old version? Do I need to use `get_mod_file_changelog`? +
You can. You must first provide the specific mod file ID, and then get_mod_file_changelog fetches the historical notes for that precise version.
How do I check which games this MCP supports using `list_games`? +
You call list_games to get a full list of all supported game IDs. This tells your agent exactly what data is available in the entire CurseForge ecosystem before you start searching for mods.
What steps do I take to get a working download link for a mod file using `get_mod_file_download_url`? +
You must first find the specific mod file ID, then pass that ID into get_mod_file_download_url. This function generates a temporary, signed URL you can use immediately to download the content.
If I have slightly corrupted local mod files, how do I find them using `get_fingerprints_matches_fuzzy`? +
This tool attempts to match your file fingerprints even if they aren't an exact match. It’s useful for recovering mods from damaged or altered local copies by finding close data matches.
How can I retrieve metadata for multiple mods at once using `get_mods_batch`? +
You pass a list of mod IDs to get_mods_batch. This lets your agent gather data points for many mods efficiently, avoiding the need to make separate API calls for each one.
How can I find mods for a specific game like Minecraft? +
You can use the search_mods tool. For Minecraft, use gameId: 432. You can further filter by searchFilter for keywords or classId for specific types like Modpacks or Resource Packs.
Can I get the direct download link for a mod file? +
Yes! Use the get_mod_file_download_url tool with the specific modId and fileId. It will return the official URL to download the file.
How do I identify a mod if I only have the file fingerprint? +
Use the get_fingerprints_matches tool. By providing the numeric fingerprint of a file, the API will return the matching mod and file details from the CurseForge database.
We've already built the connector for CurseForge. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 17 tools are live and waiting.
You're up and running in seconds.
Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.