BananaBanana MCP Server
Provides tools for generating images, videos, and speech using Google's Nano Banana, Veo, Omni, and Gemini TTS models, including text-to-image, image editing, video generation, video-to-video editing, and speech synthesis.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@BananaBanana MCP ServerCreate a photorealistic image of a mountain lake at sunrise."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
BananaBanana MCP Server
An MCP server for image, video, and speech generation — Google Nano Banana, Veo 3.1 and Gemini Omni, OpenAI GPT Image 2.5, Alibaba Qwen Image and Wan 3.0, xAI Grok Imagine Video and Gemini TTS — that lets any MCP client (Claude Code, Claude Desktop, Cursor, and more) create media pay-as-you-go with crypto or card payments and no subscription.
Endpoint:
https://bananabanana.pro/api/mcp(streamable HTTP)Auth: OAuth 2.1 (sign in — nothing to copy) or
Authorization: Bearer bb_live_…— create a keyWebsite: https://bananabanana.pro/?utm_source=mcp_readme&utm_medium=mcp_catalog · Docs & live example: https://bananabanana.pro/mcp?utm_source=mcp_readme&utm_medium=mcp_catalog
Generate images from $0.03, videos from $0.09, and speech for $0.01 per started 200 transcript characters, billed from an account balance you top up with crypto (from $1) or by card, PayPal or SEPA (from $20). Cost quotes before every expensive call, automatic refunds on failure, and one shared image/video history with the website.
Current documentation release: v1.0.12 — audited against the deployed tool schemas and model catalogue on 2026-09-30. See the changelog.
Quick Start
OAuth is the primary connection path. API keys remain available for clients without OAuth and for scripts or CI:
OAuth 2.1 (claude.ai, Claude Desktop, Claude mobile, Claude Code, MCP Inspector): add a custom connector with the URL above, press Connect and approve access. No key to copy. See docs/authentication.md.
API key (Cursor, VS Code, Windsurf, Codex, scripts, CI): create a key in your profile — https://bananabanana.pro/profile?utm_source=mcp_readme&utm_medium=mcp_catalog, API Keys section — and put it in the client config as shown below.
claude.ai / Claude Desktop / mobile (OAuth)
Settings → Connectors → Add custom connector
URL: https://bananabanana.pro/api/mcp
→ Add → Connect → approve access on bananabanana.proClaude Code
# OAuth — no key; run /mcp inside Claude Code and choose "Authenticate"
claude mcp add --transport http bananabanana https://bananabanana.pro/api/mcp
# API-key fallback for non-interactive use
claude mcp add --transport http bananabanana https://bananabanana.pro/api/mcp \
--header "Authorization: Bearer bb_live_YOUR_KEY"Claude Desktop
Use Settings → Connectors → Add custom connector and enter
https://bananabanana.pro/api/mcp, then press Connect and approve access. If your
Desktop build uses claude_desktop_config.json, the OAuth-capable mcp-remote bridge
requires Node.js:
{
"mcpServers": {
"bananabanana": {
"command": "npx",
"args": [
"-y", "mcp-remote", "https://bananabanana.pro/api/mcp"
]
}
}
}The bridge opens the OAuth sign-in flow on first use. See
docs/authentication.md for the API-key fallback.
Cursor — ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):
{
"mcpServers": {
"bananabanana": {
"url": "https://bananabanana.pro/api/mcp",
"headers": { "Authorization": "Bearer bb_live_YOUR_KEY" }
}
}
}VS Code — .vscode/mcp.json (stores the key as an encrypted prompt):
{
"servers": {
"bananabanana": {
"type": "http",
"url": "https://bananabanana.pro/api/mcp",
"headers": { "Authorization": "Bearer ${input:bb-api-key}" }
}
},
"inputs": [
{ "type": "promptString", "id": "bb-api-key", "description": "BananaBanana API key (bb_live_…)", "password": true }
]
}Windsurf — ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"bananabanana": {
"serverUrl": "https://bananabanana.pro/api/mcp",
"headers": { "Authorization": "Bearer bb_live_YOUR_KEY" }
}
}
}Ready-to-copy configs live in examples/. Once connected, ask your agent
to run list_models (free) — it returns the live model list and prices. An OAuth user
can also ask the agent to call top_up; the returned browser link grants deposit-only
access without exposing the full profile.
No MCP client? The server is plain JSON-RPC over HTTPS — call it from curl, Python
or TypeScript with no SDK: examples/no-sdk.md (runnable
scripts: generate.py, generate.mjs).
Related MCP server: Nanana AI Image Generation Server
Tools
Ten tools; the read-only and account-access tools are free. Full reference in
docs/tools.md.
Tool | What it does | Key parameters |
| List models with live USD prices, resolutions, durations, constraints. Free. | — |
| Balance, key name, daily cap, spend today. Free. | — |
| Return a balance top-up link (crypto or card). OAuth gets a one-time deposit-only link; API-key users get the profile URL. Free. | — |
| Text-to-image on Nano Banana 2 Lite / 2 / Pro, GPT Image 2.5 Flare / Sunburst or Qwen Image 3.0 Pro, up to 4K, 1–4 variants, up to 14 reference images. Lite is the default; Google images use |
|
| Multi-turn edit of a finished image by text instruction (Nano Banana models). |
|
| Video on Veo 3.1 family, Gemini Omni Flash (1.1 or 1.0), Wan 3.0 or Grok Imagine Video 1.5, optionally from a first frame, a last frame, reference images or (Wan) reference videos. Always quotes first. Returns a |
|
| Video-to-video: restyle, replace objects or relight an existing clip on Omni Flash, extend an Omni clip by 3–10 s (up to 40 s total), or rework / continue a clip on Wan 3.0. Always quotes first. |
|
| Gemini 3.1 Flash TTS speech: one speaker or a two-speaker dialogue. Returns a hosted WAV URL synchronously. |
|
| Poll a job; returns hosted media URLs (24 h) + cost/balance. Free. |
|
| Recent account history (shared with the website). Free. |
|
Image and video generation is async: generation/editing calls return a job_id; poll
get_result for the media. generate_speech is synchronous and returns its WAV URL
directly. generate_video, edit_video and multi-image generate_image quote first
and charge nothing until you repeat the call with confirm_cost.
Generated files are retained for 30 days from creation; signed download links
last 24 hours. Within the retention period, get_result can issue fresh image/video
links. Download speech from its synchronous response; it is absent from
list_generations.
Pricing
Pay-as-you-go in USD: per image, per Veo clip, per second of output for Omni Flash,
Wan 3.0 and Grok Imagine Video, and per started 200 transcript characters for speech.
Live numbers come from list_models; full tables in docs/pricing.md.
Model | Type | Price |
| Image (1024) | $0.03 |
| Image (512→4096) | $0.03 – $0.13 |
| Image (1024→4096) | $0.11 – $0.20 |
| Image (1024→4096, OpenAI) | $0.05 – $0.18 |
| Image (1024/2048, Alibaba) | $0.04 – $0.08 |
| Video (720p/1080p; 4, 6 or 8 s) | $0.10 – $0.56 |
| Video (up to 4K; 4, 6 or 8 s) | $0.35 – $2.60 |
| Video (up to 4K; 4, 6 or 8 s) | $0.70 – $4.40 |
| Video (360p–4K, sound, 3–10 s, extendable to 40 s) | $0.03 – $0.30 / s ($0.09 – $3.00) |
| Video (720p/1080p, sound, 4–10 s) | $0.10 – $0.12 / s ($0.40 – $1.20) |
| Video (480p/720p/1080p, sound, 4 – 30 s) | $0.05 – $0.20 / s ($0.20 – $6.00) |
| Video (720p/1080p, sound, 4 – 15 s) | $0.14 – $0.25 / s ($0.56 – $3.75) |
| Speech (WAV) | $0.01 / started 200 transcript characters |
Images cost $0.03–$0.20 each; video costs $0.09–$6.00 per clip. Veo is priced
per clip, while Omni Flash, Wan 3.0 and Grok Imagine Video are billed per second of
output at the vendor's own list rates. Veo generation accepts 4, 6 or 8 seconds; the
7-second prices returned by list_models are for extension jobs, not a selectable
generate_video duration. Wan 3.0 takes a first and last frame, reference images,
reference videos and a seed, and its audio track is free to switch off. Free tools:
list_models, get_account, top_up, get_result, list_generations. Failed and
content-filtered generations are refunded automatically.
Top-up bonuses can lower the effective cost: deposits of $50+ receive 5% extra balance, deposits of $100+ receive 10%, and an active partner promo code adds another 10%. Bonuses stack and apply to crypto and card deposits alike. The table shows nominal generation charges; effective out-of-pocket cost depends on the top-up bonus. Promo codes require a normal signed-in profile and are intentionally unavailable in an OAuth deposit-only session.
Why this instead of a subscription service
You pay for what you generate — nothing else. No monthly fee, no seats, no credits that expire. A quiet month costs $0; the balance you top up is the only spend.
The agent sees the price before it spends.
list_modelsreturns live prices, and video / batch calls return a quote and charge nothing until confirmed — so an agent can't run up a surprise bill.Failures don't cost you. Upstream errors and content-filter rejections are refunded automatically; optional per-key daily caps and
idempotency_keybound the downside further.Crypto or card, no subscription. Crypto top-ups start at $1 (USDT, USDC, DAI and other coins on most networks); card, PayPal and SEPA (EU) top-ups start at $20 and run inside PayPal's checkout, so card details never reach the service. Deposits of $50+ / $100+ receive 5% / 10% extra balance, and an active partner promo code adds another 10%. One balance and one image/video history are shared between MCP and the website.
Pay per call without an account (x402)
A separate HTTP endpoint, https://bananabanana.pro/api/x402, accepts USDC on Base
without an account, OAuth or an API key. It supports image, video and speech
generation. Image/speech payments settle after success; video is prepaid and failure
returns a single-use refund credit token. See docs/x402.md for the
request format, exact-price challenge, polling and input restrictions.
Registry
Published in the official MCP Registry
as pro.bananabanana/image-video. The canonical descriptor is
server.json. Look it up:
curl -s "https://registry.modelcontextprotocol.io/v0/servers?search=pro.bananabanana/image-video"Links
Website: https://bananabanana.pro/?utm_source=mcp_readme&utm_medium=mcp_catalog
MCP docs & live example: https://bananabanana.pro/mcp?utm_source=mcp_readme&utm_medium=mcp_catalog
Create an API key: https://bananabanana.pro/profile?utm_source=mcp_readme&utm_medium=mcp_catalog
x402 pay per call ·
docs/x402.mdAuthentication ·
docs/authentication.mdTools reference ·
docs/tools.mdPricing & limits ·
docs/pricing.mdTroubleshooting ·
docs/troubleshooting.mdSupport: support@bananabanana.pro
License
Apache-2.0 © BananaBanana. This repository is public documentation only — it contains no server source code, keys, or secrets.
This server cannot be deployed
Maintenance
Related MCP Connectors
Generate images and videos with frontier AI models. Pay per use; credits never expire.
Generate image, video, audio, 3D and vector media with 100+ AI models. Pay per generation.
Generate text, images, speech, music, and video with any AI model, from one credit balance.
Generate AI images, video, voiceovers and music from Claude, ChatGPT or Cursor through 50+ models (Veo 3.1, Kling 3, Seedance, Nano Banana, GPT Image, ElevenLabs). Also image editing, upscaling, background removal, face swap, transcription, voice cloning and UGC-style video ads. Sign in with OAuth — no API key to paste. Tools are annotated (read-only vs. credit-spending); failed generations are refunded.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceEnables AI-powered image generation and editing with Nano Banana, plus professional video creation with Veo3, all through Kie.ai's APIs. Includes task tracking, status monitoring, and 1080p video upgrades.34 npm24MIT
- AlicenseAqualityFmaintenanceEnables AI assistants to generate images from text prompts and transform existing images using Google Gemini's nano banana model through the Nanana AI service. Supports both text-to-image generation and image-to-image transformation capabilities.2139 npm10MIT
- AlicenseAqualityBmaintenanceUnified MCP server for Gemini media generation --Nano Banana (images), Veo 3.1 (video), TTS, and Lyria 3 (music). Single Go binary, 12 tools, supports Gemini API key and Vertex AI.129Apache 2.0
- FlicenseNot gradedqualityDmaintenanceEnables AI-powered image generation, icon creation, hero banner design, and UI beautification using Google's Gemini Nano Banana API.-