novelai-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NOVELAI_API_KEY | Yes | Persistent API Token. Required. Obtain from NovelAI → Settings → Account → Persistent API Tokens. | |
| NOVELAI_OUTPUT_DIR | No | Where images are saved. Each tool also accepts an output_dir parameter. |
Instructions
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.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| novelai_generate_imageB | Generate anime/art images with NovelAI Diffusion models (prioritizing V5 Full/Curated, V4.5). Supports natural language, Danbooru tags, multilingual prompts, transparent background, and custom dimensions. |
| novelai_img2imgA | Modify or restyle an existing image using NovelAI Image-to-Image. Applies new prompt with adjustable change strength (0.0 to 1.0) and optional noise. |
| novelai_inpaintB | Inpaint / redraw specific parts of an image using a mask. Allows replacing clothes, faces, hair, background or fixing anatomy. |
| novelai_augmentB | NovelAI Director Tools for image manipulations: remove background ('bg-removal'), extract line art ('lineart'), convert to sketch ('sketch'), colorize sketch ('colorize'), change facial expressions/emotions ('emotion'), or declutter ('declutter'). |
| novelai_upscaleB | Upscale an image with NovelAI's neural upscaler. |
| novelai_vibe_transferC | Generate a new image influenced by the style, colors, and atmosphere of a reference image (Vibe Transfer). |
| novelai_suggest_tagsB | Search and suggest valid Danbooru/NovelAI tags matching a query string. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool has a distinct purpose: upscaling, tag suggestion, generation, img2img, inpainting, augmentations, and vibe transfer. However, novelai_img2img and novelai_vibe_transfer both involve modifying or generating from an existing image, which could cause some confusion. The descriptions clarify the difference (strength vs style influence), but a user might initially hesitate.
All tools follow a consistent 'novelai_' prefix followed by a clear verb or action (generate, img2img, inpaint, augment, vibe_transfer). The naming is uniform and predictable, making it easy to understand the tool's function from its name.
7 tools is an appropriate scope for an image generation and editing MCP server. Each tool covers a distinct aspect of the workflow: generation, editing (img2img, inpaint), augmentation, style transfer, and utilities (upscale, tag suggestions). This is neither too thin nor too heavy.
The tool set covers the core image generation and editing workflows: generating new images, refining them, inpainting, style transfer, and enhancements. A notable gap is the lack of explicit image-to-image with mask (which is partially covered by inpaint) and perhaps batch processing, but the provided tools are sufficient for most common use cases. Minor gap: no explicit 'delete' or 'get' tools, but those are not typical for generation servers.