Gelbooru MCP Server

@citronlegacy

Basic information

About Gelbooru MCP Server

A Python MCP server that wraps the Gelbooru API. Connect it to any MCP-compatible client (Claude Desktop, Cursor, etc.) to search posts, look up tags, and generate Stable Diffusion prompts from real character appearance data — all directly from your AI assistant.

#anime #mcp#booru#gelbooru#prompt-engineering #stable-diffusion#prompt-generator#mcp-server

Gelbooru MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "gelbooru-mcp": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": [
        "/absolute/path/to/gelbooru_mcp.py"
      ],
      "env": {
        "GELBOORU_API_KEY": "your_api_key",
        "GELBOORU_USER_ID": "your_user_id"
      }
    }
  }
}

Gelbooru MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Gelbooru Mcp?

How to use Gelbooru Mcp?

Clone the repository, run install.sh (or install mcp manually with pip), then set the optional environment variables GELBOORU_API_KEY and GELBOORU_USER_ID. Start the server with python gelbooru_mcp.py and configure your MCP client (e.g., Claude Desktop) to run the script via the stdio transport.

Key features of Gelbooru Mcp

Stable Diffusion Prompt Generation – Build accurate SD prompts from tag frequency data.
Appearance Breakdown – Separate eye, hair, and clothing tags with frequency counts.
Advanced Post Search – Filter by tags, score, resolution, rating, uploader, and more.
Full Tag Syntax – Supports AND, OR, wildcards, exclusion, meta-tags, and sorting.
Community Tools – Search users, get post comments, and list deleted posts.
Smart Caching – Results cached for 24 hours to avoid repeated API calls.

Use cases of Gelbooru Mcp

Generate a Stable Diffusion prompt for a character by analyzing their most-tagged posts.
Find high-quality wallpaper images using score, width, and tag filters.
Check how many posts a specific tag has and discover related tags.
Retrieve comments on a given post or track recently deleted content.

Frequently asked questions

Do I need a Gelbooru API key?

API credentials are optional but strongly recommended. Without them, requests are throttled and limited to 2 tags per query. Patreon supporters of Gelbooru receive unlimited requests.

What are the runtime requirements?

Python 3.10+ and the `mcp` package. The server uses the stdio transport and does not require a web server.

How are Stable Diffusion prompts generated?

The server fetches the most-tagged `rating:general solo` posts for a character, analyzes tag frequency across eye, hair, and other categories, then assembles a ready-to-paste prompt string. Results are cached for 24 hours by default.

What tag format does Gelbooru use?

Gelbooru uses `character_(series)` format with underscores (e.g., `misty_(pokemon)`). Always convert natural language names to this format before using the tools. Use `search_tags` with `name_pattern` if unsure.

Comments

More AI & Agents MCP servers

localscreenshot - website screenshot mcp for ai agents

localscreenshot is a Website screenshot MCP server and API available at https://localscreenshot.com/api. Localscreenshot screenshot api turns any public web page into an image or a PDF. Take the capture from one of 227 c

OpenZiti MCP Gateway

openziti

NetFoundry MCP Gateway enables secure, isolated access to Model Context Protocol (MCP) tools across distributed systems without exposing public endpoints. Zero trust gateway for MCP servers. Aggregate, filter, and secure

bsv.cx

Andy Rowe

Timestamp and verify evidence on-chain. Let your agent prove what it saw and when. bsv.cx gives an AI agent verifiable memory. Timestamp a hash of any output, archive a web page as it looked, or fetch a URL with a recei

fhirHydrant

faulkj

Open-source Node.js FHIR MCP server with SMART Backend Services, metadata-aware search/CRUD tools, compact responses, FHIRPath filtering, safe pagination, audit events, and terminology lookup.

Agent Traffic Lab

ATL doesn’t just help agents find tools — it gets the job done. It finds and chooses the right AI provider, tool, or MCP server, executes the task, and switches to a fallback when a provider fails. It can optimize for lo