{"uid":"cap_u6A3dBRMw9N-Z2H7TPLcD","slug":"minecraft-mod-compatibility-api-modrinth-via-lodestone-0fa9fa4c","name":"Minecraft Mod Compatibility API (Modrinth via Lodestone)","description":"Modrinth mod compatibility checks for agents and modpack tools. 0.01 USDC per call via x402, no signup.","url":"https://mcapi.jackiscool.com/mod-search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"type":"json","example":{"results":[{"slug":"xaeros-minimap","title":"Xaero's Minimap","downloads":1000000}],"total_hits":120}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mDJCjJOzgoXlkN2i8aULt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches the Modrinth mod registry for Minecraft mods, modpacks, shaders, and resource packs filtered by loader and game version, paid per-call via x402.","exampleAgentPrompt":"Search Modrinth for minimap mods that work with Fabric on Minecraft 1.21.1 and give me the top 5 results.","exampleUseCases":[{"title":"Modpack compatibility checker","prompt":"I'm building a Fabric modpack for Minecraft 1.20.4 — can you search Modrinth for optimization mods that support Fabric 1.20.4 and list the top 10 by downloads?"},{"title":"Shader discovery for new version","prompt":"What shaders are available on Modrinth for NeoForge on Minecraft 1.21.1? Show me up to 15 results."},{"title":"Agent-driven mod suggestion","prompt":"My players want a tech mod for our Forge 1.20.1 server — search Modrinth for tech modpacks compatible with Forge 1.20.1 and return the top 5 most downloaded ones."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:33:06.770Z","isFirstParty":false,"canonicalSlug":"minecraft-mod-compatibility-api-modrinth-via-lodestone-0fa9fa4c"}