SkillFoxx

civitai-mcp-ultimate

An MCP server for Civitai: model and LoRA search, images with prompts, download commands, trend analysis, bilingual output

  • 26 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • Reaches out to the Civitai and Meilisearch APIs over the network
  • Downloads previews into a local on-disk cache
All reasons and checks

timoncool/civitai-mcp-ultimateAuthor:timoncool

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/civitai-mcp-ultimate

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Reaches out to the Civitai and Meilisearch APIs over the network
  • Downloads previews into a local on-disk cache

This is third-party code. Review the repository files before installing.

What it does

The server opens the public Civitai REST API to an agent through 14 tools. With them you can search checkpoints, LoRAs and ControlNets with filters by base model, type, tag and creator, browse top images with full generation parameters, find a model by file hash, and read a version's trigger words and download links. Text search goes through Meilisearch because Civitai's own search has been broken since mid 2025. It builds ready download commands for curl and PowerShell with ComfyUI path mapping, caches previews, and outputs in English or Russian. It is written in Python with FastMCP and runs over stdio.

Who it is for. For designers and content creators who gather Stable Diffusion, Flux and similar models and prompts through their agent.

Good fit when

  • You need to find LoRAs or checkpoints for a base model and sort them by popularity
  • You need working prompts and generation parameters from top images
  • You need a download command for a model with auth and ComfyUI layout

Not a fit when

  • You need image generation rather than search and metadata from Civitai
  • Civitai is not reachable from your network and a VPN is not an option

Example request

Find the top Flux LoRAs this month and show the best prompts for each

MCP

Transport
stdio
Authentication
key is optional

Environment variables

CIVITAI_API_KEY secret
Civitai key for NSFW access and higher rate limits, taken from account settings.
CIVITAI_MCP_LANG
Output language, en or ru, default en.
COMFYUI_MODELS_PATH
ComfyUI models path used in download commands.
MEILISEARCH_KEY
Read-only Meilisearch key, a public default is built in.

Limitations

The server sits on top of Civitai, so it depends on civitai.com being reachable, which is worth checking separately from Russia without a VPN. The CIVITAI_API_KEY is optional, but without it NSFW content is closed and rate limits are lower. Text search runs through Meilisearch because Civitai's REST search is broken. The server does not generate images itself, it only searches models and metadata and prepares download commands.

How to disable. Remove the civitai server from your MCP client config. Uninstall the package with pip uninstall civitai-mcp-ultimate if it was installed, and the preview cache lives in ~/.civitai-mcp-cache/.

FAQ

Do I need a Civitai key?

It is optional. Without a key search, images and metadata work, but NSFW content is closed and rate limits are lower. The key comes from your Civitai account settings.

Why does search go through Meilisearch?

Civitai's REST text search has been broken since mid 2025, so the server uses Meilisearch with a public read-only key that you can override with your own.

Discussion

No questions or reviews yet.

MCP servers
Official

RunAPI MCP server: a catalog of 160 models for images, video, music and speech, pricing, task runs and balance

MCP serverExtended access56
Official

An MCP server that turns phone video into a 3D scene and lets an agent measure it, plan paths and export data for robots

MCP serverBroad access656

A local MCP server sends images, video, audio and music to a multimodal model and returns a description to a text-only agent.

MCP serverExtended access120

A local MCP server for editing and analyzing images: the agent crops frames, finds objects and reads text from photos

MCP serverExtended access339
Official

An MCP server for generating images and video from the agent: several models, a large prompt library and parallel tasks

MCP serverExtended access1.8K

A community MCP server for the Kling AI API: video, images, lip sync and virtual try-on. It uploads local files to a third-party cloud bucket

MCP serverBroad access46

README in short

The README presents the server as full coverage of the public Civitai REST API v1 across 14 tools, grouped into models, images, creators and tags, and downloads. Parameters are verified against the live API, and text search is moved to Meilisearch because the native search is broken. It installs from PyPI via pip or runs through uvx, with configs for Claude Code, Claude Desktop and Smithery. Settings come from environment variables: the Civitai key, output language, ComfyUI path and a Meilisearch key. It has an auto-cleaning preview cache, an async client and retries on rate limits. MIT licensed.

README badge

Report a problem