# CurseForge MCP > 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. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** mods, minecraft, gaming, addons, curseforge-api ## Description 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. ## Tools ### 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. ### 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. ## Prompt Examples **Prompt:** ``` Search for Minecraft mods with 'industrial' in the name. ``` **Response:** ``` I found several mods. The most popular is 'Industrial Foregoing' (ID: 266515). Would you like to see its full description or available files? ``` **Prompt:** ``` Get the HTML description for mod ID 238222. ``` **Response:** ``` I've retrieved the description for 'Just Enough Items (JEI)'. It includes details on usage, keybindings, and configuration options. Should I summarize the main features for you? ``` **Prompt:** ``` List all categories available for game ID 432. ``` **Response:** ``` For Minecraft (ID: 432), I found categories such as 'Adventure and RPG', 'Magic', 'Technology', and 'Storage'. Which category would you like to explore? ``` ## Capabilities ### Discover Mods Find specific game modifications by filtering criteria like category, version, and text search. ### Retrieve Mod Details Get complete mod information, including full descriptions, author data, and lists of available files. ### Secure File Download Generate direct, signed URLs for specific mod files so you can download them without complex setup. ### Analyze Local Files Identify known mods by running local file fingerprints against the CurseForge database. ### Map Game Structure List all supported games, available version types, and mod categories for any given game ID. ## Use Cases ### 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`. ## Benefits - 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. ## How It Works The bottom line is that this MCP turns a huge, complicated website into a simple set of commands for your AI client. 1. Subscribe to the MCP and provide your CurseForge API key. 2. Tell your agent what you need—for instance, 'Find all files for Mod X from Game Y.' 3. Your agent executes the necessary calls, retrieving structured data (like file lists or download URLs) and presenting it directly in your chat. ## Frequently Asked Questions **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.