# CurseForge MCP for AI Agents AI Agent Connect > CurseForge MCP. Access the world's largest repository of gaming mods to search for projects, fetch metadata, and manage files for Minecraft, WoW, and other titles. Use it to find specific content, check changelogs, and grab direct download links instantly. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_d85JdRtavRV0RSyr9JLX8LA3kSoZ5l5EKyfis1Ou/ai-agent-connect - **Tags:** mods, minecraft, gaming, addons, curseforge-api ## Description This Connector turns your AI client into a direct link to the CurseForge ecosystem. Instead of jumping between browser tabs to find the right mods for Minecraft or World of Warcraft, you can just tell your agent what you need. It handles the heavy lifting of searching through projects, pulling detailed descriptions, and grabbing the exact files you need for your game. You can check changelogs to see what changed in a recent update or get direct download links for your game packs. It even helps you identify mods from local files by matching fingerprints. Finding the right content becomes a conversation rather than a manual chore. If you are tired of manually verifying version numbers or hunting for specific mod categories, this tool takes that off your plate. You can browse through the available games and version types to ensure everything is compatible before you hit install. It is designed to make mod discovery faster and more organized for anyone who spends time customizing their gaming experience. For example, if you are building a massive mod pack, you can ask your agent to gather all the download links for a specific list of mods so you can keep them organized in one place. It removes the need to click through every single mod page to find the actual download button. You can find this Connector in the Vinkius catalog to get started quickly. ## Tools ### get_game Get details for a specific game. This helps you understand a game's specific requirements and metadata. ### list_games List all games available to your API key. Use this to see what titles the Connector can access. ### get_mod_description Get the HTML description of a mod. This provides the full details of what a mod actually does. ### get_mod_file_changelog Get the HTML changelog for a specific file. This lets you see exactly what changed in an update. ### get_mod_file_download_url Get a signed download URL for a specific file. Use this to grab the actual file for your game. ### list_mod_files Get all files for a specific mod. This helps you see every version or component available. ### search_mods Search for mods based on criteria. This is your primary way to find new content. ### list_game_versions_v1 Get all available versions for a game (V1). Use this to see standard versioning for a title. ### get_mod_file Get details for a specific file of a mod. This shows you the specifics of a single mod asset. ### get_mod Get details for a specific mod. This pulls the core information for a mod project. ### get_mods_batch Get a list of mods by their IDs. Use this to pull info on multiple mods at once. ### list_game_versions_v2 Get detailed version information for a game (V2). This provides more granular data on game versions. ### list_categories Get all available classes and categories for a game. Use this to browse mod types like magic or tech. ### get_files_batch Get a list of files by their IDs. This pulls multiple files in one go. ### get_fingerprints_matches_fuzzy Get matches for a list of file fingerprints using fuzzy matching. This helps identify mods when the data isn't perfect. ### get_fingerprints_matches Get matches for a list of file fingerprints. Use this to identify mods from your local files. ### list_game_version_types Get all available version types for a game. This helps you understand different ways games are versioned. ## 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? | Mod Name | ID | Key Category | | :--- | :--- | :--- | | Industrial Foregoing | 266515 | Technology | ``` **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 instructions * Keybindings * 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 the following categories: * Adventure and RPG * Magic * Technology * Storage Which category would you like to explore? ``` ## Capabilities ### Search for mods by game Find specific projects based on your preferred game and category. ### Fetch full mod details Pull descriptions and author information for any mod in the database. ### Get direct download links Retrieve signed URLs for specific files to use in your game packs. ### Check version changelogs View the latest update notes for specific mod files. ### Identify local mods Match file fingerprints to identify which mods are currently installed. ### Browse game categories List all available categories and version types for a specific game. ## Use Cases ### Finding industrial mods for Minecraft A user asks for 'industrial mods for Minecraft 1.20' and the agent uses `search_mods` and `list_categories` to find a list of relevant projects. ### Checking a specific mod's update A game host admin wants to know what changed in a mod and uses `get_mod_file_changelog` to get the latest notes without leaving their chat. ### Identifying mods from a folder A player has a folder of files and uses `get_fingerprints_matches` to see which mods are actually installed on their machine. ### Gathering download links for a game pack A creator wants a list of links for a mod pack and uses `get_mod_file_download_url` to get them all in a single list. ## Benefits - Skip the manual search. Use `search_mods` to find exactly what you need by filtering for specific games and categories. This saves you from clicking through dozens of web pages to find the right content for your setup. - Stay updated on mod changes. Use `get_mod_file_changelog` to see what changed in a recent update instantly. You can check for bug fixes or new features without hunting for a separate notes page. - Get direct links. Use `get_mod_file_download_url` to grab files for your game packs without searching for buttons. Your agent can collect these links for you in a list. - Understand mod details. Use `get_mod_description` to get the full context and author info in one go. You can quickly see what a mod does before you decide to install it. - Identify local files. Use `get_fingerprints_matches` to see which mods are actually in your folder. This is great for verifying your installation or finding missing assets. - Explore game categories. Use `list_categories` to see every type of mod available for a specific title. This helps you discover new content types like magic or technology. ## How It Works The bottom line is you get a direct line to the CurseForge database without the manual browsing. 1. Connect the CurseForge MCP to your AI client via Vinkius. 2. Enter your CurseForge API key to authorize the connection. 3. Ask your agent to find mods, pull descriptions, or grab download links. ## Frequently Asked Questions **Can the CurseForge MCP find mods for games other than Minecraft?** Yes, it supports a wide range of games including World of Warcraft and others listed in the CurseForge database. **How do I get download links for my game pack?** Your agent can use the Connector to find specific files and generate signed download URLs for you automatically. **Can I use the CurseForge MCP to see what changed in a mod update?** Yes, it can pull the HTML changelogs for specific files so you can see the latest notes instantly. **Does the CurseForge MCP help identify mods I already have?** It can match local file fingerprints to the CurseForge database to tell you which mods are currently installed on your machine. **Can I search for mods by specific categories like 'Magic' or 'Tech'?** Yes, the Connector can list all categories for a game so your agent can filter results accurately for your specific needs. **Is there a way to get full descriptions of mods?** The Connector can pull the complete HTML description, including author information and other metadata. **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.