Nano Banana 2 Polza MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| POLZA_BASE_URL | No | База API, по умолчанию https://polza.ai/api | https://polza.ai/api |
| IMAGE_OUTPUT_DIR | No | Директория для сохранённых файлов, по умолчанию ~/nanobanana-images | ~/nanobanana-images |
| NANOBANANA_MODEL | No | Дефолтный tier: auto, nb2, pro, flash | auto |
| POLZA_AI_API_KEY | Yes | Токен доступа к Polza API | |
| RETURN_FULL_IMAGE | No | Возвращать полное изображение в MCP-ответе вместо thumbnail | |
| POLZA_EXTERNAL_USER_ID | No | Передаётся в Polza как user для антифрода | |
| POLZA_POLL_TIMEOUT_SECONDS | No | Таймаут ожидания генерации, по умолчанию 120 | 120 |
| POLZA_POLL_INTERVAL_SECONDS | No | Интервал поллинга статуса, по умолчанию 2 | 2 |
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": true
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {
"tasks": {
"list": {},
"cancel": {},
"requests": {
"tools": {
"call": {}
},
"prompts": {
"get": {}
},
"resources": {
"read": {}
}
}
}
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| generate_imageA | Generate new images or edit existing images using natural language instructions. Supports multiple input modes:
Automatically detects mode based on parameters or can be explicitly controlled. Input images are read from the local filesystem to avoid massive token usage. Returns both MCP image content blocks and structured JSON with metadata. |
| upload_fileA | Upload a local file through the Polza Storage API and return its URI & metadata. Useful when the image is larger than 20MB or reused across prompts. |
| show_output_statsA | Show statistics about the output directory and recently generated images. |
| maintenanceB | Perform maintenance operations following workflows.md patterns. Available operations:
|
| fetch_generationD | – |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| photorealistic_shot | Generate a prompt for high-quality photorealistic images. |
| logo_text | Generate a prompt for logo creation with accurate text rendering. |
| product_shot | Generate a prompt for studio product photography. |
| sticker_flat | Generate a prompt for flat/kawaii style stickers. |
| iterative_edit_instruction | Generate an instruction for precise image editing. |
| composition_and_style_transfer | Generate an instruction for style transfer and composition blending. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| prompt_templates_catalog | A compact catalog of prompt templates (same schemas as the @mcp.prompt items). |
| list_operations | List all tracked operations. Returns: Dict with list of operations and summary statistics |
TDQS
Scored across 5 tools
Most tools have clear descriptions, but 'fetch_generation' lacks any description, creating ambiguity about its purpose and potential overlap with 'generate_image'. This makes it hard for an agent to distinguish between them.
Tool names consistently use snake_case, but they mix verb and noun forms (e.g., 'maintenance' is a noun while others are verb+noun). The pattern is partially predictable but not fully uniform.
With 5 tools, the server covers core image generation and file management tasks reasonably well. The count is appropriate for a focused service, though not overly extensive.
The tool set lacks a way to list or delete previously generated images, and 'fetch_generation' is undefined. This leaves significant gaps in the lifecycle, likely causing agent failures during cleanup or retrieval tasks.