mcp-nanobanana-pro

Server Details

MCP server for NanoBanana AI image generation and editing

Status: Unhealthy
Last Tested: 2026-03-27 10:31
Transport: Streamable HTTP
URL
Repository: AceDataCloud/MCPNanoBanana
GitHub Stars: 2
Server Listing: MCP NanoBanana

See and control every tool call

Log every tool call with full inputs and outputs

Control which tools are enabled per connector

Manage credentials once, use from any MCP client

Monitor uptime and get alerted when servers go down

Available Tools

4 tools

nanobanana_edit_imageInspect

Edit or combine images using AI based on a text prompt.

This allows you to modify existing images or combine multiple images together.
Perfect for virtual try-on, product placement, image enhancement, and more.

Use this when:
- You want to combine multiple images (e.g., person + clothing)
- You want to modify an existing image
- You need virtual try-on (putting clothes on a person)
- You want to place products in different scenes
- You need to change attributes (materials, colors, styles)

Common use cases:
- Portrait replacement: Try different clothing on same person
- Product scene composition: Place products in realistic environments
- Attribute replacement: Change materials, colors, or variants
- Poster editing: Rapidly change styles or themes
- 2D to 3D conversion: Convert images to 3D product mockups
- Image restoration: Restore old or damaged photos

Returns:
    Task ID, trace ID, and edited image URL.

ParametersJSON Schema

Name	Required	Description	Default
`model`	No	Model to use for editing. 'nano-banana' (default, alias of gemini-2.5-flash-image) is faster. 'nano-banana-2' is an improved version with better quality. 'nano-banana-pro' (alias of gemini-3-pro-image) offers highest quality.	nano-banana
`prompt`	Yes	Description of the edit to perform. Describe how the images should be combined or modified. Example: 'let this person wear this T-shirt', 'place this product in a modern kitchen scene'
`image_urls`	Yes	List of image URLs to edit. Can be HTTP/HTTPS URLs (publicly accessible) or Base64-encoded images (data:image/png;base64,...). When combining multiple images, describe their relationship in the prompt.
`callback_url`	No	Optional webhook URL to receive the result asynchronously. The API will POST the result to this URL when complete.

nanobanana_generate_imageInspect

Generate an AI image from a text prompt using Google's Nano Banana model.

This creates high-quality images from detailed text descriptions. The more
descriptive your prompt, the better the results.

Use this when:
- You want to generate a new image from scratch
- You have a detailed description of the desired image
- You need photorealistic or artistic image generation

Prompt writing tips:
- Include: Main subject + Atmosphere + Lighting + Camera/Lens + Quality keywords
- Example: "Urban career woman, backlit sunlight, film grain, orange-gold tones, hopeful dawn"

Returns:
    Task ID, trace ID, and generated image URL.

ParametersJSON Schema

Name	Required	Description	Default
`model`	No	Model to use for generation. 'nano-banana' (default, alias of gemini-2.5-flash-image) is faster. 'nano-banana-2' is an improved version with better quality. 'nano-banana-pro' (alias of gemini-3-pro-image) offers highest quality and supports resolution parameter.	nano-banana
`prompt`	Yes	Description of the image to generate. Be descriptive about subject, atmosphere, lighting, camera/lens, and quality. Example: 'A photorealistic close-up portrait of an elderly Japanese ceramicist with deep wrinkles and a warm smile, soft golden hour light, 85mm portrait lens, bokeh background'
`resolution`	No	Resolution of the generated image. Options: '1K' (default), '2K', '4K'. Only works with 'nano-banana-pro' model.
`aspect_ratio`	No	Aspect ratio of the generated image. Options: '1:1' (square, default), '3:2', '2:3', '16:9' (landscape), '9:16' (portrait), '4:3', '3:4'.	1:1
`callback_url`	No	Optional webhook URL to receive the result asynchronously. The API will POST the result to this URL when complete.

nanobanana_get_taskInspect

Query the status and result of an image generation or edit task.

Use this to check if a generation/edit is complete and retrieve the resulting
image URLs and metadata.

Use this when:
- You want to check if an image generation has completed
- You need to retrieve image URLs from a previous generation
- You want to get the full details of a generated/edited image

Returns:
    Task status and image information including URLs and prompts.

ParametersJSON Schema

Name	Required	Description	Default
`task_id`	Yes	The task ID returned from a generation or edit request. This is the 'task_id' field from any nanobanana_generate_image or nanobanana_edit_image tool response.

nanobanana_get_tasks_batchInspect

Query multiple image generation/edit tasks at once.

Efficiently check the status of multiple tasks in a single request.
More efficient than calling nanobanana_get_task multiple times.

Use this when:
- You have multiple pending generations to check
- You want to get status of several images at once
- You're tracking a batch of generations

Returns:
    Status and image information for all queried tasks.

ParametersJSON Schema

Name	Required	Description	Default
`task_ids`	Yes	List of task IDs to query. Allows querying multiple tasks at once.

Verify Ownership

Claim this connector by publishing a /.well-known/glama.json file on your server's domain with the following structure:

{
  "$schema": "https://glama.ai/mcp/schemas/connector.json",
  "maintainers": [
    {
      "email": "your-email@example.com"
    }
  ]
}

The email address must match the email associated with your Glama account. Once verified, the connector will appear as claimed by you.

Server Details

Available Tools

Verify Ownership

Discussions

Your Connectors

Resources