CurseForge Connector for AI agents.

17 live capabilities

Find and manage game mods for Minecraft and WoW.

Live agent request CurseForge / Connector

Waiting for input…

AI Agent

Why people use CurseForge

CurseForge for Minecraft and WoW Mod Management

This Connector changes that by letting your agent do the digging for you. Just tell your agent what you are looking for and it pulls the descriptions, categories, and download links into one view. You get a clear list of options and the direct links to get them running.

What Vinkius changes

You get a direct line to the CurseForge database without the manual browsing.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 6,100+ Connectors

Real-world use case 01

Finding industrial mods for Minecraft

A user asks for 'industrial mods for Minecraft 1.
Real-world use case 02

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.
Real-world use case 03

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.

Complete set · 17capabilities

The complete CurseForge capability set.

These are the exact actions your AI can choose when you ask it to work with CurseForge.

Capability set01 / 05

01—04

4 capabilities in this set.

Part of 17 available through CurseForge.

01 Capability
Get game
Get details for a specific game. This helps you understand a game's specific requirements and metadata.
02 Capability
List games
List all games available to your API key. Use this to see what titles the Connector can access.
03 Capability
Get mod description
Get the HTML description of a mod. This provides the full details of what a mod actually does.
04 Capability
Get mod file changelog
Get the HTML changelog for a specific file. This lets you see exactly what changed in an update.

Capability set02 / 05

05—08

4 capabilities in this set.

Part of 17 available through CurseForge.

05 Capability
Get mod file download url
Get a signed download URL for a specific file. Use this to grab the actual file for your game.
06 Capability
List mod files
Get all files for a specific mod. This helps you see every version or component available.
07 Capability
Search mods
Search for mods based on criteria. This is your primary way to find new content.
08 Capability
List game versions v1
Get all available versions for a game (V1). Use this to see standard versioning for a title.

Capability set03 / 05

09—11

3 capabilities in this set.

Part of 17 available through CurseForge.

09 Capability
Get mod file
Get details for a specific file of a mod. This shows you the specifics of a single mod asset.
10 Capability
Get mod
Get details for a specific mod. This pulls the core information for a mod project.
11 Capability
Get mods batch
Get a list of mods by their IDs. Use this to pull info on multiple mods at once.

Capability set04 / 05

12—14

3 capabilities in this set.

Part of 17 available through CurseForge.

12 Capability
List game versions v2
Get detailed version information for a game (V2). This provides more granular data on game versions.
13 Capability
List categories
Get all available classes and categories for a game. Use this to browse mod types like magic or tech.
14 Capability
Get files batch
Get a list of files by their IDs. This pulls multiple files in one go.

Capability set05 / 05

15—17

3 capabilities in this set.

Part of 17 available through CurseForge.

15 Capability
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.
16 Capability
Get fingerprints matches
Get matches for a list of file fingerprints. Use this to identify mods from your local files.
17 Capability
List game version types
Get all available version types for a game. This helps you understand different ways games are versioned.

Set up in minutes

One URL. Then ask CurseForge to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use CurseForge from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_d85JdRtavRV0RSyr9JLX8LA3kSoZ5l5EKyfis1Ou/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it CurseForge, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable CurseForge for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_d85JdRtavRV0RSyr9JLX8LA3kSoZ5l5EKyfis1Ou/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the CurseForge URL.
Step 03

Save and start

Save the connection and enable CurseForge in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "curseforge": {
      "url": "https://edge.vinkius.com/vk_preview_d85JdRtavRV0RSyr9JLX8LA3kSoZ5l5EKyfis1Ou/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using CurseForge

Open Agent mode in chat and ask: "Using CurseForge, help me...". 17 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "curseforge": {
      "url": "https://edge.vinkius.com/vk_preview_d85JdRtavRV0RSyr9JLX8LA3kSoZ5l5EKyfis1Ou/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using CurseForge

Ask Copilot: "Using CurseForge, help me...". 17 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "curseforge": {
      "url": "https://edge.vinkius.com/vk_preview_d85JdRtavRV0RSyr9JLX8LA3kSoZ5l5EKyfis1Ou/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using CurseForge

Open Cascade and ask: "Using CurseForge, help me...". 17 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "curseforge": {
      "url": "https://edge.vinkius.com/vk_preview_d85JdRtavRV0RSyr9JLX8LA3kSoZ5l5EKyfis1Ou/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using CurseForge

Ask Cline: "Using CurseForge, help me...". 17 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add curseforge --transport http "https://edge.vinkius.com/vk_preview_d85JdRtavRV0RSyr9JLX8LA3kSoZ5l5EKyfis1Ou/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using CurseForge

Ask Claude: "Using CurseForge, show me...". 17 tools are ready

Where the request belongs

Work CurseForge can move forward.

Built around the request

This is for modders who need to organize large libraries, game host admins building community packs, and developers who want to integrate CurseForge data into custom capabilities.

01

Mod Pack Creator

Uses this to gather dozens of download links and changelogs into a single organized list for a new release.

02

Game Host Admin

Checks for mod updates and verifies version compatibility for a multiplayer community environment.

03

Capability Developer

Builds custom mod management software by using the AI as a bridge to the CurseForge API.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 10 capabilities

Modrinth

Search and manage Minecraft projects via Modrinth. discover mods, resource packs, and plugins directly from your AI agent.

02 35 capabilities

Modio

Manage game mods and community content via mod.io. list games, browse mods, manage files, and track statistics directly from your AI agent.

03 22 capabilities

Mod.io

Manage game mods, browse titles, and handle subscriptions via mod.io. discover, rate, and organize game content directly from any AI agent.

04 10 capabilities

Heybox

Access Heybox (小黑盒) gamer database. track Steam/PUBG/CS2 statistics and monitor community trends directly from any AI agent.

05 7 capabilities

Steam

Access game data, player profiles, and community content from the world largest PC gaming platform and digital storefront.

06 4 capabilities

itch.io

Access your itch.io account. browse your games, collections and profile info from any AI agent.

Bring your own AI

Change the model, client or framework. Keep CurseForge connected.

Before you connect

Questions about CurseForge.

The practical details behind the request, access and result.

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 capability. 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 capability 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 capability. By providing the numeric fingerprint of a file, the API will return the matching mod and file details from the CurseForge database.

One connection away

Give your agent a direct line to CurseForge.

Connect CurseForge once. Keep it beside 6,100+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available