Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use CurseForge with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Access the world's largest repository of gaming mods. search for projects, fetch metadata, and manage mod files for Minecraft, WoW, and more.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 17 capabilities

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.

  1. 01

    Get game

    Get details for a specific game

  2. 02

    List mod files

    Get all files for a specific mod

  3. 03

    Get fingerprints matches

    Used for identifying mods from local files. Get matches for a list of file fingerprints

  4. 04

    Get mod description

    Get the HTML description of a mod

Capability set02 / 05

05-08

4 capabilities in this set.

Part of 17 available through CurseForge.

  1. 05

    Get mod file

    Get details for a specific file of a mod

  2. 06

    Get mod file changelog

    Get the HTML changelog for a specific file

  3. 07

    Get mod file download URL

    Get a signed download URL for a specific file

  4. 08

    List games

    List all games available to the API key

Capability set03 / 05

09-11

3 capabilities in this set.

Part of 17 available through CurseForge.

  1. 09

    List game versions v1

    Get all available versions for a game (V1)

  2. 10

    List game versions v2

    Get detailed version information for a game (V2)

  3. 11

    List game version types

    Get all available version types for a game

Capability set04 / 05

12-14

3 capabilities in this set.

Part of 17 available through CurseForge.

  1. 12

    Search mods

    Search for mods based on criteria

  2. 13

    Get mod

    Get details for a specific mod

  3. 14

    Get mods batch

    Get a list of mods by their IDs

Capability set05 / 05

15-17

3 capabilities in this set.

Part of 17 available through CurseForge.

  1. 15

    Get fingerprints matches fuzzy

    Get matches for a list of file fingerprints using fuzzy matching

  2. 16

    List categories

    Get all available classes and categories for a game

  3. 17

    Get files batch

    Get a list of files by their IDs

Observed, not estimated

983ms average. Fast in production.

CurseForge is checked daily against the live service.

Daily averagePeak 1249ms
Aug 20Today
Fastest day
794ms
Slowest day
1249ms
14-day trend
Slowing+13%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 17 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of CurseForge, so you can see the experience inside your AI.

It does not authenticate your account with CurseForge. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

CurseForge Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_d85JdRtavRV0RSyr9JLX8LA3kSoZ5l5EKyfis1Ou/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — CurseForge capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "curseforge-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_d85JdRtavRV0RSyr9JLX8LA3kSoZ5l5EKyfis1Ou/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions CurseForge owners ask.

  • 01

    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.

  • 02

    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.

  • 03

    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.

Explore

More in Developer Tools

Suggestions