CurseForge API

Name: CurseForge 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.

Install Jentic One Beta

Connect the CurseForge API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the CurseForge API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with CurseForge 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

GET STARTED

Start building with CurseForge API

Explore with Jentic

View OpenAPI Document

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 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 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.

FAQs

Specific to using CurseForge 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.

CurseForge API

Connect the CurseForge API to your agent

Capabilities

Start building with CurseForge API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs