Schema | Gelbooru MCP

Gelbooru MCP

Describes the environment variables required to run the server.

Name	Required	Description	Default
`GELBOORU_API_KEY`	No	Your Gelbooru API Key. Found on your account options page. Optional but recommended to avoid rate limiting.
`GELBOORU_USER_ID`	No	Your Gelbooru User ID. Found on your account options page. Optional but recommended to avoid rate limiting.
`GELBOORU_CACHE_DIR`	No	Custom cache folder path for storing analyzed character tag data.	.gelbooru_cache/
`GELBOORU_CACHE_TTL`	No	Cache lifetime in seconds (default is 24 hours).	86400

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Features and capabilities supported by this server

Protocol revision2025-11-25

Capability	Details
`tools`	{ "listChanged": false }
`experimental`	{}

Functions exposed to the LLM to take actions

Name	Description
search_postsA	Search Gelbooru posts by tags, page, limit, or ID. Supports all Gelbooru tag syntax: AND (tag1 tag2), OR ({t1~t2}), NOT (-tag), wildcards (tag / tag), meta-tags like rating:safe/questionable/explicit, score:>=N, width:>=N, user:name, sort:random, sort:score:desc, etc.
get_deleted_postsC	Retrieve deleted posts. Pass last_id to get everything deleted above that post ID.
search_tagsB	Search Gelbooru tags by name, pattern, or ID. Useful for autocomplete, tag counts, and tag type lookup.
search_usersC	Search Gelbooru users by name or name pattern.
get_commentsC	Retrieve comments for a specific Gelbooru post.
get_character_tagsA	Given a character name (e.g. 'misty_(pokemon)'), fetches the top highest-scored general/solo posts across multiple pages and returns the most frequently occurring tags split into three semantic buckets: eye colour/shape, hair colour/style, and other character traits. Each tag includes a frequency score. Results are cached to disk for 24 hours.
build_promptA	Given a character name, returns a ready-to-use image-generation prompt string like 'misty (pokemon), green eyes, orange hair, side ponytail, ...'. Internally calls get_character_tags with caching, then assembles the prompt with tags ordered by frequency (eye → hair → other).

Interactive templates invoked by user choice

Name	Description
No prompts

Contextual data attached and managed by the client

Name	Description
No resources

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/citronlegacy/gelbooru-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server