CurseForge API

Name: CurseForge API API
Brand: CurseForge API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentDeveloper ToolsPackage RegistryapiKey22 EndpointsREST

For Agents

Search game mods, retrieve mod files and changelogs, match installed addons by fingerprint, and resolve Minecraft versions and mod loaders.

Quickstart

Get started with CurseForge API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"search game mods on curseforge"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with CurseForge API API.

Search mods across supported games with category, version, and sort filters

Retrieve mod metadata, descriptions, and changelogs for a specific mod or version

Generate signed download URLs for mod files attached to a mod

Match installed addon files to known mods using fingerprint and fuzzy fingerprint endpoints

GET STARTED

Start building with CurseForge API API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for CurseForge API, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for CurseForge API, keeping it validated and agent-ready. CurseForge is a long-running distribution platform for game mods and addons, particularly for Minecraft, World of Warcraft, and other titles. The API provides programmatic access to the catalogue of games, mods, files, categories, and Minecraft-specific resources, with endpoints for searching mods, fetching mod files and changelogs, fingerprint matching for installed addons, and resolving Minecraft versions and mod loaders. Authentication is by an x-api-key header.

Use Cases

Patterns agents use CurseForge API API for, with concrete tasks.

★ Mod Manager and Launcher Integration

Power a third-party Minecraft launcher or mod manager that lets users browse, install, and update mods from CurseForge. Use /v1/mods/search for discovery, /v1/mods/{modId}/files for version listings, and /v1/mods/{modId}/files/{fileId}/download-url to retrieve a signed URL for the actual jar. Suitable for desktop launchers, container builders, and modpack assemblers.

Call GET /v1/mods/search with gameId for Minecraft and searchFilter='create', then GET /v1/mods/{modId}/files to list available versions, then GET /v1/mods/{modId}/files/{fileId}/download-url to fetch the jar

Installed Mod Identification

Identify a folder of unknown mod jars by computing the CurseForge fingerprint of each file and submitting them to /v1/fingerprints. The endpoint returns matched mod and file IDs so a tool can resolve names, versions, and update paths. Useful for migration tools, sync utilities, and modpack diff viewers.

Compute fingerprints for files in a mods folder, then POST /v1/fingerprints with the fingerprint list to resolve them to known CurseForge mod IDs

Modpack Build and Compatibility Check

Build a modpack manifest and verify each mod is compatible with a target Minecraft version and mod loader. Combine /v1/games/{gameId}/versions for the version catalogue, /v1/minecraft/modloader for loader options, and /v1/mods/{modId}/files for per-mod file metadata to assemble a coherent pack.

Call GET /v1/minecraft/version to list versions, then for each candidate mod call GET /v1/mods/{modId}/files and filter by gameVersion=1.20.4 and modLoader=Forge

Mod Discovery Page

Render a discovery page that surfaces featured and trending mods alongside category browsing. Use POST /v1/mods/featured for curated lists and GET /v1/categories for navigation, then deep-link into mod detail pages with /v1/mods/{modId} and /v1/mods/{modId}/description.

Call POST /v1/mods/featured with gameId for Minecraft to fetch popular and recently updated mods for a homepage carousel

AI Agent Mod Lookup via Jentic

An AI agent helping a user find or update Minecraft mods uses Jentic to call CurseForge directly. The agent searches for 'search mods', loads /v1/mods/search, supplies a gameId and search filter, and returns the matching mod list to the user without manual integration work.

Use Jentic to search 'search mods' and execute /v1/mods/search with gameId for Minecraft and searchFilter='shader' to recommend shader mods

Key Endpoints

22 endpoints — jentic publishes the only available openapi specification for curseforge api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/v1/mods/search

Search mods with filters

GET

/v1/mods/{modId}

Get mod details

GET

/v1/mods/{modId}/files

List files for a mod

GET

/v1/mods/{modId}/files/{fileId}/download-url

Get a signed download URL

POST

/v1/fingerprints

Match files to mods by fingerprint

POST

/v1/mods/featured

Get featured and popular mods

GET

/v1/minecraft/version

List Minecraft versions

GET

/v1/minecraft/modloader

List Minecraft mod loaders

GET

/v1/mods/search

Search mods with filters

GET

/v1/mods/{modId}

Get mod details

GET

/v1/mods/{modId}/files

List files for a mod

GET

/v1/mods/{modId}/files/{fileId}/download-url

Get a signed download URL

POST

/v1/fingerprints

Match files to mods by fingerprint

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

CurseForge x-api-key values are stored encrypted in the Jentic vault and injected into the request header at call time. The agent never sees or stores the raw key.

Intent-based discovery

Agents search by intent (e.g. 'search mods', 'fingerprint match', 'list minecraft versions') and Jentic returns the matching CurseForge operation with its parameter schema.

Time to first call

Direct CurseForge integration: 1 day for auth, fingerprint computation, and file download flow. Through Jentic: under 1 hour — search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Modrinth API

Open-source mod hosting platform with similar search, project, and version endpoints

Choose Modrinth if you want an open-source-friendly mod platform or need projects that are not on CurseForge.

Alternative

Modrinth API

Direct alternative for Minecraft mod search and download

Use this Modrinth endpoint when you specifically want the api.modrinth.com host coverage.

Complementary

Twitch API

Game streaming platform commonly used alongside mod platforms for community content

Pair with CurseForge when building tools that surface streamer-recommended mods or game-related content.

FAQs

Specific to using CurseForge API API through Jentic.

Why is there no official OpenAPI spec for CurseForge API?

CurseForge does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call CurseForge API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the CurseForge API use?

The API uses an API key sent in the x-api-key request header. Through Jentic the key is held in the encrypted vault and injected at execution time, so the raw key never enters the agent's prompt.

Can I download mod files with the CurseForge API?

Yes. Call GET /v1/mods/{modId}/files/{fileId}/download-url to obtain a signed URL for the file, then issue a standard HTTP GET to that URL to fetch the jar.

What are the rate limits for the CurseForge API?

Rate limits are governed by the CurseForge developer terms and are not encoded in the spec; high-volume usage typically requires explicit approval. Check your CurseForge developer console for the quota that applies to your key.

How do I identify mods already installed in a folder?

Compute the Murmur2 fingerprint for each jar file, then POST /v1/fingerprints with the list. The response maps each fingerprint to a CurseForge mod and file ID where a match exists, with /v1/fingerprints/fuzzy available for near matches.

How do I list supported Minecraft versions through Jentic?

Run pip install jentic, search for 'list minecraft versions', load /v1/minecraft/version, and execute it. Jentic returns the catalogue of versions you can pass as a filter on /v1/mods/{modId}/files.