Vinkius
CurseForge

CurseForge MCP for AI. Manage Mod Files and Game Versions Instantly

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

CurseForge MCP on Cursor AI Code EditorCurseForge MCP on Claude Desktop AppCurseForge MCP on OpenAI Agents SDKCurseForge MCP on Visual Studio CodeCurseForge MCP on GitHub Copilot AI AgentCurseForge MCP on Google Gemini AICurseForge MCP on Lovable AI DevelopmentCurseForge MCP on Mistral AI AgentsCurseForge MCP on Amazon AWS Bedrock

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.

+ 14 more capabilities included
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.

Included with Plan

Waiting for input…

AI Agent

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 Vinkius

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.

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.

Claude AI

Claude AI

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

3

Start a conversation

Open a new chat. The CurseForge integration is available immediately — no restart needed.

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
Start building

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
CurseForge MCP server cover

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

Your data is protected. See how we built it.

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.

Built · Hosted · Managed by Vinkius CurseForge MCP - Manage Gaming Mod Files & Versions
Server ID 019e5d0f-576e-70d3-8bea-fe5057cc2f4a
Vinkius Inspector
Compliance Grade A+
Score 98.33/100
Vinkius Inspector Badge — Score 98.33/100

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.

Built & Managed by Vinkius 30s setup 17 tools

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 runs on Claude Claude
Vinkius runs on ChatGPT ChatGPT
Vinkius runs on Cursor Cursor
Vinkius runs on Gemini Gemini
Vinkius runs on Windsurf Windsurf
Vinkius runs on VS Code VS Code
Vinkius runs on JetBrains JetBrains
Vinkius runs on Vercel Vercel
+ other MCP clients

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.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.