• MATCHED
  • FUZZY
  • MISSING
  • HUMAN

How to identify local mod files with your AI

Connect CurseForge to your AI client to scan your local files. Your agent can then cross-reference file fingerprints against the official database to pinpoint exactly what you have installed.

Ask AI about this page

Short answer

How can I identify local mod files with my AI?

Your AI client uses file fingerprints to match your local files against the CurseForge database. It identifies the specific mod name and version for every file you provide. You'll get a clear list of what's installed and what might be missing or outdated.

The results you get.

Where your file data lands.

The AI processes your local fingerprints and maps them to the cloud.

MATCHED

Exact mod matches

The AI finds direct hits in the CurseForge database. You get the specific mod name and version number for each file.

FUZZY

Probable mod matches

When fingerprints aren't perfect, the AI uses fuzzy matching to suggest the most likely mod candidates. This helps catch slightly altered files.

MISSING

Unrecognized files

Files that don't match any known CurseForge entries are flagged. This shows you which files are custom or unsupported.

HUMAN

Manual verification

You decide which fuzzy matches are correct. The AI provides the data, but you make the final call on version conflicts.

The workflow

What your AI does when the files arrive.

The AI acts as a bridge between your local file system and the CurseForge repository.

  1. Generate fingerprints

    Your AI client reads the local files to create unique digital signatures for each one.

    get_fingerprints_matches

  2. Search database

    The AI sends these signatures to CurseForge to find exact matches in their registry.

    get_fingerprints_matches

  3. Handle near-matches

    If an exact match isn't found, the AI runs a fuzzy search to find the closest possible mod versions.

    get_fingerprints_matches_fuzzy

  4. Report findings

    The AI compiles the results into a list of identified mods, versions, and unknown files.

    get_fingerprints_matchesget_fingerprints_matches_fuzzy

Try it

Copy these to start.

Use these prompts to begin your identification task.

Starting points

These are starting points. Replace the bracketed text with your specific file paths or mod names.

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"
    }
  }
}
Copy into chat04

  • Identify the mods in my local folder at [path/to/mods].

  • Check these file fingerprints against CurseForge: [fingerprint_list].

  • Find fuzzy matches for these local files: [file_list].

  • Compare my current mod list with the CurseForge database to find version mismatches.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect CurseForge once, then ask.

One connection gives your AI access to the CurseForge database. Your login credentials stay encrypted and secure on our side.

Connect CurseForge to your AI

FAQ

How this task behaves.

  • 01

    Can the AI automatically install mods for me?

    No. The AI can only identify and match files against the database. You must handle all file movements and installations yourself.

  • 02

    What happens if a file doesn't match anything?

    The AI will report it as an unrecognized file. It won't guess unless you specifically ask it to use fuzzy matching.

  • 03

    Does the AI change my local files?

    No. The AI only reads file fingerprints to perform matches. It has no capability to modify, delete, or move your local files.

  • 04

    Can it find mods not hosted on CurseForge?

    No. The AI is limited to the CurseForge database. It cannot search other mod repositories or external websites.

  • 05

    How accurate is the fuzzy matching?

    Fuzzy matching is a best-effort tool. It identifies likely candidates when fingerprints aren't exact, but you should always verify the results.

  • More questions about CurseForge? The Connector page answers them. See everything the CurseForge Connector can do

Connect CurseForge to Claude, Cursor, ChatGPT & more