Civitai MCP Ultimate
Ultimate MCP server for Civitai API β search models, browse top images with prompts, download LoRAs/Checkpoints, analyze trends. Bilingual (EN/RU). Python + FastMCP.
Ask AI about Civitai MCP Ultimate
Powered by Claude Β· Grounded in docs
I know everything about Civitai MCP Ultimate. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
civitai-mcp-ultimate
The most complete MCP server for Civitai API β search models, browse images with prompts, download LoRAs/Checkpoints, analyze trends.
All from your AI assistant. 14 tools covering 100% of the Civitai public REST API v1.
All API parameters verified against real Civitai API on 2026-03-24. No guessing, no copying from broken implementations.
Features
- Meilisearch-powered search β fast, accurate text search (Civitai REST API search is broken since May 2025)
- Search models β Checkpoints, LoRAs, ControlNets with 40+ base model filters (SD 1.5 β Flux.2)
- Top images with prompts β sort by reactions, comments, collections. Get full generation params
- Download commands β curl/PowerShell commands with auth, ComfyUI path auto-mapping
- NSFW support β full NSFW access with API key (None/Soft/Mature/X filtering)
- Image/video cache β auto-download previews to
~/.civitai-mcp-cache/, 24h auto-cleanup - Bilingual output β English and Russian (
CIVITAI_MCP_LANG=ru) - Async & fast β httpx async client, retry with backoff on rate limits
- 14 tools covering 100% of the Civitai public REST API v1
Quick Start
Install from PyPI
pip install civitai-mcp-ultimate
Claude Code
claude mcp add civitai -e CIVITAI_API_KEY=your_key_here -- uvx civitai-mcp-ultimate
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"civitai": {
"command": "uvx",
"args": ["civitai-mcp-ultimate"],
"env": {
"CIVITAI_API_KEY": "your_key_here"
}
}
}
}
pip
pip install civitai-mcp-ultimate
civitai-mcp-ultimate
Tools
Models (6 tools)
| Tool | Description |
|---|---|
search_models | Search via Meilisearch (text) or REST API (filters). Type, base model, tag, creator, sort |
get_model | Full model details by ID |
get_model_version | Version details: files, trigger words, download URLs |
get_model_version_by_hash | Find model by file hash |
get_top_checkpoints | Top checkpoints by base model (SDXL, Flux, Pony...) |
get_top_loras | Top LoRAs by base model |
Images (4 tools)
| Tool | Description |
|---|---|
browse_images | Browse images with filters and sorting |
get_top_images | Top images by reactions/comments/collections |
get_model_images | Example images for a model with prompts |
get_image_generation_data | Full generation params from top images |
Creators & Tags (2 tools)
| Tool | Description |
|---|---|
get_creators | Browse/search model creators |
get_tags | Browse/search model tags |
Downloads (2 tools)
| Tool | Description |
|---|---|
get_download_url | Authenticated download URL |
get_download_info | Download commands (curl/PowerShell) + ComfyUI path mapping |
Supported Filters
Base Models (all verified working)
SD 1.5, SD 1.5 LCM, SD 1.5 Hyper, SD 2.0, SD 2.1, SDXL 1.0, SDXL Lightning, SDXL Hyper, Flux.1 S, Flux.1 D, Flux.1 Krea, Flux.1 Kontext, Flux.2 D, Flux.2 Klein 9B/4B, Pony, Pony V7, Illustrious, NoobAI, Anima, ZImageBase, AuraFlow, Chroma, HiDream, Hunyuan 1, Kolors, PixArt a/E, Lumina, CogVideoX, Hunyuan Video, LTXV/LTXV2, Mochi, Wan Video (all variants)
Model Types
Checkpoint, LORA, LoCon, TextualInversion, Hypernetwork, Controlnet, Poses, AestheticGradient, Wildcards, MotionModule, VAE, Upscaler, Workflows, Other
Image Sort
Most Reactions, Most Comments, Most Collected, Newest, Oldest
Configuration
| Variable | Required | Default | Description |
|---|---|---|---|
CIVITAI_API_KEY | Recommended | β | API key for NSFW access + higher rate limits |
CIVITAI_MCP_LANG | No | en | Output language: en or ru |
COMFYUI_MODELS_PATH | No | β | ComfyUI models path for download commands |
MEILISEARCH_KEY | No | built-in | Meilisearch search-only key (public, has default) |
Get your API key: Civitai Account Settings
Examples
> Search for the top Flux LoRAs this month
> Show me the most popular SDXL checkpoints
> Get the best prompts for model 12345
> Give me download commands for this LoRA into my ComfyUI
> Find NSFW LoRAs for Illustrious sorted by reactions
Development
git clone https://github.com/timoncool/civitai-mcp-ultimate
cd civitai-mcp-ultimate
pip install -e ".[dev]"
pytest
ΠΠ²ΡΠΎΡ
Nerual Dreming (t.me/nerual_dreming) β neuro-cartel.com | ΠΎΡΠ½ΠΎΠ²Π°ΡΠ΅Π»Ρ ArtGeneration.me
Other Projects by @timoncool
| Project | Description |
|---|---|
| telegram-api-mcp | Full Telegram Bot API as MCP server |
| trail-spec | TRAIL β cross-MCP content tracking protocol |
| ACE-Step Studio | AI music studio β songs, vocals, covers, videos |
| VideoSOS | AI video production in the browser |
| Bulka | Live-coding music platform |
| GitLife | Your life in weeks β interactive calendar |
Support the Author
I build open-source software and do AI research. Most of what I create is free and available to everyone. Your donations help me keep creating without worrying about where the next meal comes from =)
All donation methods | dalink.to/nerual_dreming | boosty.to/neuro_art
- BTC:
1E7dHL22RpyhJGVpcvKdbyZgksSYkYeEBC - ETH (ERC20):
0xb5db65adf478983186d4897ba92fe2c25c594a0c - USDT (TRC20):
TQST9Lp2TjK6FiVkn4fwfGUee7NmkxEE7C
Star History
License
MIT
