Server Configuration
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 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_posts | 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_posts | Retrieve deleted posts. Pass last_id to get everything deleted above that post ID. |
| search_tags | Search Gelbooru tags by name, pattern, or ID. Useful for autocomplete, tag counts, and tag type lookup. |
| search_users | Search Gelbooru users by name or name pattern. |
| get_comments | Retrieve comments for a specific Gelbooru post. |
| get_character_tags | 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_prompt | 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). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |