CurseForge MCP. Manage mod files, versions, and discovery data.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
CurseForge MCP Server accesses the world's largest repository of gaming mods. Your AI client can search for mods by game ID or category, fetch detailed metadata, manage file lists, and get direct download URLs for Minecraft, WoW, and other games.
It's deep access to mod discovery and file management.
What your AI agents can do
Get files batch
Retrieves a list of files given a batch of file IDs.
Get fingerprints matches
Identifies mods by matching a list of file fingerprints against the database.
Get fingerprints matches fuzzy
Matches file fingerprints against the mod database using fuzzy matching logic.
Your agent finds mods by running search_mods using criteria like category, version, or name.
Your agent pulls complete information, including descriptions and author data, for any mod using get_mod or get_mod_description.
Your agent gets the list of supported games, available categories, and version types using list_games, list_categories, or list_game_version_types.
Your agent fetches specific files, changelogs, and generates signed download URLs using get_mod_file and get_mod_file_download_url.
Your agent compares local file fingerprints against the mod database using get_fingerprints_matches or get_fingerprints_matches_fuzzy.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
CurseForge MCP Server: 17 Tools for Mod Management
Use these 17 tools to programmatically search, list, and retrieve every piece of mod metadata and file content from CurseForge.
019e5d0fget files batch
Retrieves a list of files given a batch of file IDs.
019e5d0fget fingerprints matches
Identifies mods by matching a list of file fingerprints against the database.
019e5d0fget fingerprints matches fuzzy
Matches file fingerprints against the mod database using fuzzy matching logic.
019e5d0fget game
Gets specific details for a single game title.
019e5d0fget mod
Pulls core details for a specific mod ID.
019e5d0fget mod description
Retrieves the full HTML description for a mod.
019e5d0fget mod file
Gets specific file details for a mod.
019e5d0fget mod file changelog
Retrieves the HTML changelog for a specific mod file.
019e5d0fget mod file download url
Generates a signed, temporary URL to download a specific mod file.
019e5d0fget mods batch
Retrieves a list of mods given a batch of mod IDs.
019e5d0flist categories
Retrieves all available categories and classes for a given game.
019e5d0flist game version types
Lists all version types supported by a game.
019e5d0flist game versions v1
Retrieves all available versions for a game (Version 1 structure).
019e5d0flist game versions v2
Retrieves detailed version information for a game (Version 2 structure).
019e5d0flist games
Lists all game titles supported by the CurseForge API key.
019e5d0flist mod files
Gets a complete list of files associated with a specific mod.
019e5d0fsearch mods
Searches for mods using defined criteria like keywords, game ID, or category.
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 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
You're hooking up your AI agent to the CurseForge API. This gives you deep access to the whole goddamn modding world. You can search, pull metadata, and handle mod files for games like Minecraft and WoW, all without leaving your chat window.
Search and Filter Mods
Your agent can run search_mods to find mods using criteria like keywords, game ID, or category. You can also see every supported game with list_games and check out all the categories for a specific game using list_categories. For version info, your agent can get all supported version types with list_game_version_types, or pull all available versions using list_game_versions_v1 and list_game_versions_v2.
Get Mod Details
Need the scoop on a mod? Your agent pulls the full scoop using get_mod or gets the full HTML description with get_mod_description. You can also pull all the files tied to a mod with list_mod_files, and grab the specific details for any single mod file using get_mod_file. If you need to know what changed, your agent pulls the mod file's HTML changelog with get_mod_file_changelog.
Download and Identify Files
Your agent handles the files. It generates a signed, temporary download URL for any specific mod file using get_mod_file_download_url. You can pull a list of files given a batch of file IDs using get_files_batch. If you've got local files, your agent compares their fingerprints to the mod database using get_fingerprints_matches or get_fingerprints_matches_fuzzy to figure out what mods they are.
Manage Mod Batches
Your agent can pull a list of mods given a batch of mod IDs using get_mods_batch.
How CurseForge MCP Works
- 1 Subscribe to the server and provide your CurseForge API Key to your AI client.
- 2 Your AI client instructs the agent to run a specific tool (e.g., 'Search for mods using the
search_modstool'). - 3 The server executes the API call, retrieves the data, and sends the structured results back to your client.
The bottom line is, you feed the API key to your client, and the agent handles the complex data fetching and structure for you.
Who Is CurseForge MCP For?
This is for mod developers and technical teams who manage large, complex content libraries. If you spend time cross-referencing file versions, checking mod compatibility, or gathering download links manually, this saves you hours. It’s for people who need structured data from the gaming world, not just casual players.
Uses get_mod and get_mod_description to pull detailed metadata and changelogs for mods they are integrating.
Runs search_mods and get_mod_file_download_url to test specific mod versions and ensure all necessary files are present.
Uses list_games and list_categories to map out the full scope of available mod content across different game titles.
What Changes When You Connect
- Find mods quickly. Use
search_modsto filter by game ID, category, or text. You don't need to click through dozens of result pages just to find the right mod. - Get full context on mods. Running
get_modpulls all core details, whileget_mod_descriptiongives you the full HTML text. This is better than scraping a webpage. - Streamline version tracking. You can list all available versions using
list_game_versions_v1orlist_game_versions_v2, giving you a complete history of a mod's compatibility. - Automate file downloads. Instead of manually copying links, use
get_mod_file_download_urlto generate a signed, usable link for any mod file. - Handle unknown files. If you have a local mod file, run
get_fingerprints_matchesto automatically match it against the database, saving manual comparison time.
Real-World Use Cases
Building a Mod Compatibility Report
A QA engineer needs to confirm all mods for Minecraft (ID: 432) work with the latest version. They ask their agent to first run list_game_versions_v2 to get the current version, then use search_mods to find all relevant mods, and finally run get_mod_file_download_url for the core files to build a verifiable manifest.
Debugging a Missing Mod File
A mod developer discovers a mod is missing a required asset. They run list_mod_files on the mod ID and then use get_mod_file_changelog to see exactly which version the file was added in, quickly identifying the gap.
Identifying a Unknown Local Mod
A modder has a local file and needs to know what mod it belongs to. They run get_fingerprints_matches with the file's fingerprint, and the agent returns the matching mod ID and name, solving the identification problem instantly.
Mapping Game Content Scope
A content team lead needs to know every type of mod available for a specific game. They run list_games to see all supported titles, then list_categories on the target game ID to map out the content structure.
The Tradeoffs
Guessing Mod IDs
The developer tries to guess a mod ID and calls get_mod_description or get_mod_file without knowing the ID, leading to a 404 error and requiring multiple manual attempts.
→
First, run search_mods with keywords or game IDs to get a list of potential mod IDs. Then, pass the confirmed ID to get_mod to pull the correct metadata.
Ignoring File Versions
A QA tester checks the mod description but doesn't know if the file is compatible with the current game version, potentially testing against outdated requirements.
→
Always check the version list. Run list_game_versions_v1 or list_game_versions_v2 to confirm the current version type, then use get_mod_file to see the file's version context.
Downloading everything at once
The user tries to list every single file for a mod using a single, massive API call, which hits rate limits and times out.
→
Use list_mod_files to get the full file list first. If you need files in batches, use get_files_batch with the IDs you collected.
When It Fits, When It Doesn't
Use this server if your job involves structured data extraction from gaming content. Specifically, if you need to map mod dependencies, compare file fingerprints, or systematically gather metadata across multiple versions. It’s essential for modding tools, QA, and content management systems.
Don't use this if you just need general mod recommendations or want to browse the site like a human. If your goal is simple discovery, you can often achieve 80% of the result just by searching Google. You need this when the process is data-heavy: when you need to know which file is needed, which version it belongs to, and how to get it programmatically.
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 server provides 17 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Manually checking mod compatibility shouldn't take 20 tabs and 3 hours.
Right now, checking a mod's compatibility means navigating to the CurseForge website. You click the mod, you check the description for version numbers, you find the files tab, and you manually compare the required version against the game's current build. This is slow, prone to copy-paste errors, and you're missing the full picture of what's actually available.
With this MCP server, you tell your agent to check compatibility. The agent runs `search_mods` and then `list_game_versions_v2`. You get the current version, the list of mods, and the metadata—all returned in one structured data payload. No clicking required.
CurseForge MCP Server: Get download links and file versions instantly.
You don't have to copy the download URL from the web page. Instead, your agent runs `get_mod_file_download_url` with the specific mod ID and file ID. The server returns a signed URL that works immediately for your script or application.
This isn't just data retrieval. This is a programmatic file delivery system. You get reliable, usable links, every time.
Common Questions About CurseForge MCP
How do I find all mods for a specific game using `search_mods`? +
You must provide the game ID as a filter when calling search_mods. This narrows the search to only the relevant mods, preventing you from getting a massive, unusable list of all mods across all games.
Can I use `get_mod_file_download_url` without knowing the mod ID? +
No. This tool requires three specific inputs: the mod ID, the file ID, and the game ID. Providing all three ensures the server returns the correct, signed link for that exact file.
What's the difference between `get_mod` and `get_mod_description`? +
get_mod returns the mod's core metadata (ID, name, author). get_mod_description fetches only the full HTML text of the description field.
How do I list all available mod files for a mod? +
Use the list_mod_files tool. This call returns a comprehensive list of every file associated with a given mod ID, giving you all the necessary file IDs.
What is `get_fingerprints_matches_fuzzy` for? +
This tool performs fuzzy matching. You pass a list of file fingerprints, and it finds potential mod matches even if the file name or metadata is slightly different or corrupted.
How do I find all available versions for a game using `list_game_versions_v2`? +
It returns detailed version information for a game. This list includes version numbers and the specific release date for each one. You can then use this data to narrow down which mod files you need to check.
What is the purpose of `get_fingerprints_matches`? +
get_fingerprints_matches identifies mods from local files. You pass a list of file fingerprints, and the tool returns the corresponding mod IDs and metadata. This is useful for matching files you already have to known mods.
Can I list all available categories for a game using `list_categories`? +
Yes, list_categories fetches every class and category associated with a game ID. This helps you understand the full structure of the mod ecosystem before you start searching for mods.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Deterministic JWT Inspector
Transform your AI into a cybersecurity diagnostic tool. Instantly decode and inspect JSON Web Tokens (Headers, Payloads, and Expiry metadata) without requiring signature keys.
NVIDIA AI
Access LLMs, embeddings, code generation, and reasoning via NVIDIA API Catalog.
Blockchair (Universal Blockchain Search Engine & API)
Query blocks, transactions, and addresses across multiple blockchains like Bitcoin and Ethereum using Blockchair's universal API.
You might also like
Helpshift
Automate mobile and web support via Helpshift — manage issues, FAQs, and user profiles directly from any AI agent.
ClickHouse (Vector Search)
Manage vector embeddings and SQL via ClickHouse — list databases, execute SQL, and perform high-speed vector searches directly from any AI agent.
Vimeo Alternative
Manage your Vimeo video library, search for content, and update video metadata directly from your AI agent.