# Minecraft Mod Compatibility API (Modrinth via Lodestone)

> Minecraft Mod Compatibility API (Modrinth via Lodestone) is a paid API for AI agents from mcapi.jackiscool.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-29).

Searches the Modrinth mod registry for Minecraft mods, modpacks, shaders, and resource packs filtered by loader and game version, paid per-call via x402.

## Facts

- Endpoint: GET https://mcapi.jackiscool.com/mod-search?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/minecraft-mod-compatibility-api-modrinth-via-lodestone-0fa9fa4c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_u6A3dBRMw9N-Z2H7TPLcD

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability minecraft-mod-compatibility-api-modrinth-via-lodestone-0fa9fa4c
```

Example prompt: Search Modrinth for minimap mods that work with Fabric on Minecraft 1.21.1 and give me the top 5 results.

## When to prefer this

Choose this endpoint when an AI agent or modpack tool needs to programmatically search Modrinth for Minecraft content (mods, modpacks, shaders, resource packs, datapacks, plugins) filtered by loader and game version, without requiring a Modrinth API key or user account — especially useful in agentic pipelines that can pay per-call via x402.

## Known failure modes

- Missing required 'query' parameter returns an error
- Invalid loader value (e.g. misspelled) may return zero results or an error
- Invalid Minecraft version string returns empty results
- Payment failure via x402 blocks the request before execution
- Modrinth upstream downtime causes service unavailability

## How this service works

Modrinth mod compatibility checks for agents and modpack tools. 0.01 USDC per call via x402, no signup.

## Output

Returns a JSON object with a 'results' array of matching mods/content, each containing at minimum a slug, title, and download count, plus a 'total_hits' integer indicating how many total results exist for the query on Modrinth.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "type": {
       "type": "string",
       "description": "mod|modpack|shader|resourcepack|datapack|plugin (default mod)"
      },
      "limit": {
       "type": "integer",
       "description": "1-20 (default 10)"
      },
      "query": {
       "type": "string",
       "description": "Search words, e.g. minimap"
      },
      "loader": {
       "type": "string",
       "description": "fabric|forge|neoforge|quilt (optional)"
      },
      "version": {
       "type": "string",
       "description": "Minecraft version, e.g. 1.21.1 (optional)"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "results": [
   {
    "slug": "xaeros-minimap",
    "title": "Xaero's Minimap",
    "downloads": 1000000
   }
  ],
  "total_hits": 120
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/minecraft-mod-compatibility-api-modrinth-via-lodestone-0fa9fa4c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcapi.jackiscool.com](https://www.zero.xyz/host/mcapi.jackiscool.com/llms.txt)