Modrinth API

Name: Modrinth API
Brand: Modrinth API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentDeveloper ToolsPackage Registrybearer26 EndpointsREST

For Agents

Search, publish, and manage Minecraft mods on Modrinth: search projects, create and modify projects and versions, look up versions by file hash, manage user profiles, and read tag taxonomies.

Install Jentic One Beta

Connect the Modrinth API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Modrinth 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 Modrinth API.

Search Modrinth projects by query, facets, and filters with pagination

Create new projects and modify or delete existing projects on behalf of an authenticated user

List, create, modify, and delete versions for a project including dependency declarations

GET STARTED

Start building with Modrinth API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI specification for Modrinth API, keeping it validated and agent-ready. Modrinth is an open mod hosting platform for Minecraft mods, modpacks, resource packs, and shaders, served by the Labrinth backend. The API exposes 26 endpoints covering project search, project and version CRUD, multi-id batch fetches, version-by-file-hash lookups, user profile management, project team membership, tag taxonomies, and instance statistics. It is a strong fit for mod launchers, automated update checkers, and any tool building a Minecraft modding pipeline.

Use Cases

Patterns agents use Modrinth API for, with concrete tasks.

★ Mod Launcher Update Checker

Build a Minecraft launcher that detects which installed mods have new versions on Modrinth by hashing each local jar and calling /version_file/{hash}. The launcher then offers users one-click updates. Most launchers ship a working hash-based updater in 2 to 3 days using the public read API.

Compute the SHA-512 of every jar in the user's mods folder, call /version_file/{hash} for each, and present any version where versionId is newer than the locally installed one.

Automated Mod Publishing

Wire Modrinth into a CI pipeline so that every tagged release on GitHub publishes a new version to Modrinth via POST /version. The job uploads the jar, sets dependency constraints, and updates the project description if the changelog has changed. Typical setup is a day to script the release.

After a successful GitHub release for project 'tinkers-auto-smelt', call POST /version with the jar attached, version_number from the release tag, and game_versions ['1.21'].

Modpack Curation Dashboard

A modpack curator can use /search and /projects to browse and batch-fetch project metadata, then surface a curated list to their community. The /tag endpoints supply the categories and loader filters that drive faceted UI. Most teams build the dashboard in a week.

Call /search with facets ['categories:adventure', 'project_type:modpack', 'versions:1.21'] and present the top 50 results sorted by downloads.

AI Modding Assistant

An AI assistant for Minecraft modders can answer 'find me a shader pack that works with Iris on 1.20.4' or 'publish the new version of my mod' through Jentic. Modrinth bearer tokens stay in the MAXsystem vault and never enter agent context. Setup is under an hour.

Use Jentic to search for 'search Modrinth projects', execute /search with the user's natural-language query parsed into facets, and present the top 10 matches.

Key Endpoints

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

METHOD

PATH

DESCRIPTION

GET

/search

Search Modrinth projects

GET

/project/{idOrSlug}

Get a project by ID or slug

POST

/project

Create a new project

POST

/version

Create a new version of a project

GET

/version_file/{hash}

Get a version from a file hash

GET

/user

Get the authenticated user

GET

/tag/category

List all categories

GET

/search

Search Modrinth projects

GET

/project/{idOrSlug}

Get a project by ID or slug

POST

/project

Create a new project

POST

/version

Create a new version of a project

GET

/version_file/{hash}

Get a version from a file hash

GET

Why Jentic?

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

Credential isolation

Modrinth bearer tokens are stored encrypted in the Jentic MAXsystem vault. Agents call Modrinth through Jentic with a scoped session — the raw token never appears in prompts, code, or logs.

Intent-based discovery

Agents search by intent — 'search Minecraft mods' or 'publish a new mod version' — and Jentic returns matching Modrinth operations with input schemas, removing the need to read the Modrinth developer docs.

Time to first call

Direct integration with Modrinth: 1 to 2 days for search and basic project reads, longer for the full publishing flow. Through Jentic: under an hour from sign-up to first executed call.

FAQs

Specific to using Modrinth API through Jentic.

Why is there no official OpenAPI spec for Modrinth API?

Modrinth (Labrinth) does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Modrinth 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 Modrinth API use?

Modrinth uses HTTP token authentication under the tokenAuth bearer scheme. Generate a personal access token from your Modrinth profile and pass it as a bearer token. Through Jentic, the token is stored encrypted in the MAXsystem vault and the agent receives only a scoped session at execution time.

Can I look up a Modrinth version by file hash?

Yes. GET /version_file/{hash} resolves a SHA-1 or SHA-512 hash to the version that owns the file. This is the standard way for mod launchers to detect installed mods and check for available updates.

What are the rate limits for the Modrinth API?

Modrinth applies a 300 requests per minute rate limit on its public API. Authenticated requests share that pool; if you exceed it, the API returns 429 with a Retry-After header. Cache aggressively when paginating large result sets.

How do I publish a new mod version with the Modrinth API through Jentic?

Run pip install jentic, then search for 'create a new mod version'. Jentic returns the POST /version operation schema. Execute it with the project_id, version_number, game_versions, loader, and primary file payload, then verify with GET /version/{id}.

Does the Modrinth API support project search with facets?

Yes. GET /search accepts the query parameter for free text plus facets for project_type, categories, versions, loaders, and license. This is the same engine that powers the modrinth.com search experience.

Modrinth API

Connect the Modrinth API to your agent

Capabilities

Start building with Modrinth API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs