{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_khdczd29s2k5","handle":"civitai-mcp-ultimate","url":"https://wellknown.network/agents/civitai-mcp-ultimate","links":{"self":"https://wellknown.network/agents/civitai-mcp-ultimate/record.json","html":"https://wellknown.network/agents/civitai-mcp-ultimate","markdown":"https://wellknown.network/agents/civitai-mcp-ultimate/record.md","api":"https://wellknown.network/api/v1/agents/civitai-mcp-ultimate","status":"https://wellknown.network/api/v1/agents/civitai-mcp-ultimate/status","claim":"https://wellknown.network/agents/civitai-mcp-ultimate/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/civitai-mcp-ultimate/claim.json","badge":"https://wellknown.network/agents/civitai-mcp-ultimate/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/civitai-mcp-ultimate/history","tools":"https://wellknown.network/api/v1/agents/civitai-mcp-ultimate/tools"},"ard":{"identifier":"urn:air::server:civitai-mcp-ultimate","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"civitai-mcp-ultimate","summary":"Ultimate MCP server for Civitai API — search models, browse top images with prompts, download LoRAs/Checkpoints, analyze trends","description":"# civitai-mcp-ultimate\n\n[![PyPI](https://img.shields.io/pypi/v/civitai-mcp-ultimate)](https://pypi.org/project/civitai-mcp-ultimate/)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)\n[![MCP](https://img.shields.io/badge/MCP-compatible-purple.svg)](https://modelcontextprotocol.io/)\n\n**The most complete MCP server for [Civitai](https://civitai.com) API.** Search models, browse top images with prompts, download LoRAs/Checkpoints, analyze trends — all from your AI assistant.\n\n> All API parameters verified against real Civitai API on 2026-03-24. No guessing, no copying from broken implementations.\n\n---\n\n## Features\n\n- **Meilisearch-powered search** — fast, accurate text search (Civitai REST API search is broken since May 2025)\n- **Search models** — Checkpoints, LoRAs, ControlNets with 40+ base model filters (SD 1.5 → Flux.2)\n- **Top images with prompts** — sort by reactions, comments, collections. Get full generation params\n- **Download commands** — curl/PowerShell commands with auth, ComfyUI path auto-mapping\n- **NSFW support** — full NSFW access with API key (None/Soft/Mature/X filtering)\n- **Image/video cache** — auto-download previews to `~/.civitai-mcp-cache/`, 24h auto-cleanup\n- **Bilingual output** — English and Russian (`CIVITAI_MCP_LANG=ru`)\n- **Async & fast** — httpx async client, retry with backoff on rate limits\n- **14 tools** covering 100% of the Civitai public REST API v1\n\n---\n\n## Quick Start\n\n### Install from PyPI\n\n```bash\npip install civitai-mcp-ultimate\n```\n\n### Claude Code\n```bash\nclaude mcp add civitai -e CIVITAI_API_KEY=your_key_here -- uvx civitai-mcp-ultimate\n```\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"civitai\": {\n      \"command\": \"uvx\",\n      \"args\": [\"civitai-mcp-ultimate\"],\n      \"env\": {\n        \"CIVITAI_API_KEY\": \"your_key_here\"\n    …","publisher":null,"homepage":"https://github.com/timoncool/civitai-mcp-ultimate","repository":"https://github.com/timoncool/civitai-mcp-ultimate","version":"0.2.0","license":null,"protocols":["mcp"],"tags":["ai-models","civitai","comfyui","flux","lora","mcp","sdxl","stable-diffusion"],"pricing":null,"endpoints":[{"url":"pypi:civitai-mcp-ultimate","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"media.image-generation","name":"Image Generation","confidence":1,"provenance":"declared"}],"categories":["media"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"civitai-mcp-ultimate","registry":"pypi","observedAt":"2026-10-27T21:24:52.960Z","publishedAt":"2026-03-24T03:27:24.857522Z","latestVersion":"0.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"civitai-mcp-ultimate","url":"https://pypi.org/project/civitai-mcp-ultimate/","firstSeenAt":"2026-09-09T11:30:43.610Z","fetchedAt":"2026-10-27T21:24:10.493Z","normalizedAt":"2026-10-27T21:24:10.493Z"}]},"firstSeenAt":"2026-09-09T11:30:43.610Z","updatedAt":"2026-10-27T21:24:52.960Z"}