Other clients (Cursor, VS Code, Windsurf)

\n\n**Cursor** — `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project):\n\n```json\n{\n \"mcpServers\": {\n \"bananabanana\": {\n \"url\": \"https://bananabanana.pro/api/mcp\",\n \"headers\": { \"Authorization\": \"Bearer bb_live_YOUR_KEY\" }\n }\n }\n}\n```\n\n**VS Code** — `.vscode/mcp.json` (stores the key as an encrypted prompt):\n\n```json\n{\n \"servers\": {\n \"bananabanana\": {\n \"type\": \"http\",\n \"url\": \"https://bananabanana.pro/api/mcp\",\n \"headers\": { \"Authorization\": \"Bearer ${input:bb-api-key}\" }\n }\n },\n \"inputs\": [\n { \"type\": \"promptString\", \"id\": \"bb-api-key\", \"description\": \"BananaBanana API key (bb_live_…)\", \"password\": true }\n ]\n}\n```\n\n**Windsurf** — `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"bananabanana\": {\n \"serverUrl\": \"https://bananabanana.pro/api/mcp\",\n \"headers\": { \"Authorization\": \"Bearer bb_live_YOUR_KEY\" }\n }\n }\n}\n```\n\n

\n\nReady-to-copy configs live in [`examples/`](https://github.com/bananabanana-pro-mcp/bananabanana-mcp/blob/main/examples). Once connected, ask your agent\nto run `list_models` (free) — it returns the live model list and prices. An OAuth user\ncan also ask the agent to call `top_up`; the returned browser link grants deposit-only\naccess without exposing the full profile.\n\n**No MCP client?** The server is plain JSON-RPC over HTTPS — call it from curl, Python\nor TypeScript with no SDK: [`examples/no-sdk.md`](https://github.com/bananabanana-pro-mcp/bananabanana-mcp/blob/main/examples/no-sdk.md) (runnable\nscripts: [`generate.py`](https://github.com/bananabanana-pro-mcp/bananabanana-mcp/blob/main/examples/generate.py), [`generate.mjs`](https://github.com/bananabanana-pro-mcp/bananabanana-mcp/blob/main/examples/generate.mjs)).\n\n## Tools\n\nTen tools; the read-only and account-access tools are free. Full reference in\n[`docs/tools.md`](https://github.com/bananabanana-pro-mcp/bananabanana-mcp/blob/main/docs/tools.md).\n\n| Tool | What it does | Key parameters |\n|---|---|---|\n| `list_models` | List models with live USD prices, resolutions, durations, constraints. Free. | — |\n| `get_account` | Balance, key name, daily cap, spend today. Free. | — |\n| `top_up` | Return a balance top-up link. OAuth gets a one-time deposit-only link; API-key users get the profile URL. Free. | — |\n| `generate_image` | Text-to-image (Nano Banana 2 Lite / 2 / Pro), up to 4K, 1–4 variants. Lite is the default; choose Nano Banana 2 for resolutions above 1024. Returns a `job_id`. | `prompt`, `model`, `aspect_ratio`, `resolution`, `number_of_images`, `confirm_cost` |\n| `edit_image` | Multi-turn edit of a finished image by text instruction. | `source_generation_id`, `prompt`, `model`, `resolution` |\n| `generate_video` | Video (Veo 3.1 family or Omni Flash), optionally from a start frame and reference images. Always quotes first. Returns a `job_id`. | `prompt`, `model`, `duration`, `resolution`, `with_audio`, `first_frame`, `reference_images`, `confirm_cost` |\n| `edit_video` | Video-to-video editing on Omni Flash: restyle, replace objects, relight an existing clip. Always quotes first. | `prompt`, `source_generation_id` or `video_url`, `duration`, `audio_prompt`, `confirm_cost` |\n| `generate_speech` | Gemini 3.1 Flash TTS speech: one speaker or a two-speaker dialogue. Returns a hosted WAV URL synchronously. | `text`, `voice`, `language_code`, `style`, `speakers` |\n| `get_result` | Poll a job; returns hosted media URLs (24 h) + cost/balance. Free. | `job_id`, `wait_seconds` |\n| `list_generations` | Recent account history (shared with the website). Free. | `limit`, `type`, `status` |\n\nImage and video generation is async: generation/editing calls return a `job_id`; poll\n`get_result` for the media. `generate_speech` is synchronous and returns its WAV URL\ndirectly. `generate_video`, `edit_video` and multi-image `generate_image` **quote first\nand charge nothing** until you repeat the call with `confirm_cost`.\n\n## Pricing\n\nPay-as-you-go in USD: per image, per Veo clip, per second for Omni Flash, and per\nstarted 200 transcript characters for speech. Live numbers come from `list_models`;\nfull tables in [`docs/pricing.md`](https://github.com/bananabanana-pro-mcp/bananabanana-mcp/blob/main/docs/pricing.md).\n\n| Model | Type | Price |\n|---|---|---|\n| `nano-banana-2-lite` | Image (1024) | $0.03 |\n| `nano-banana-2` | Image (512→4096) | $0.03 – $0.13 |\n| `nano-banana-pro` | Image (1024→4096) | $0.11 – $0.20 |\n| `veo-3.1-lite` | Video (720p/1080p; 4, 6 or 8 s) | $0.10 – $0.56 |\n| `veo-3.1-fast` | Video (up to 4K; 4, 6 or 8 s) | $0.35 – $2.60 |\n| `veo-3.1` | Video (up to 4K; 4, 6 or 8 s) | $0.70 – $4.40 |\n| `omni-flash` | Video (720p, sound, 3–10 s) | $0.10 / s ($0.30 – $1.00) |\n| `gemini-3.1-flash-tts-preview` | Speech (WAV) | $0.01 / started 200 transcript characters |\n\nImages cost **$0.03–$0.20** each; video costs **$0.10–$4.40** per clip, with Omni\nFlash billed at **$0.10/s**. Veo generation accepts 4, 6 or 8 seconds; the 7-second\nprices returned by `list_models` are for extension jobs, not a selectable\n`generate_video` duration. Free tools: `list_models`, `get_account`, `top_up`,\n`get_result`, `list_generations`. Failed and content-filtered generations are refunded\nautomatically.\n\nTop-up bonuses can lower the effective cost: deposits of $50+ receive 5% extra\nbalance, deposits of $100+ receive 10%, and an active partner promo code adds another\n10%. Bonuses stack. The table shows nominal generation charges; effective\nout-of-pocket cost depends on the top-up bonus. Promo codes require a normal signed-in\nprofile and are intentionally unavailable in an OAuth deposit-only session.\n\n## Why this instead of a subscription service\n\n- **You pay for what you generate — nothing else.** No monthly fee, no seats, no credits\n that expire. A quiet month costs $0; the balance you top up is the only spend.\n- **The agent sees the price before it spends.** `list_models` returns live prices, and\n video / batch calls return a quote and charge nothing until confirmed — so an agent\n can't run up a surprise bill.\n- **Failures don't cost you.** Upstream errors and content-filter rejections are\n refunded automatically; optional per-key daily caps and `idempotency_key` bound the\n downside further.\n- **Crypto top-ups, no card required.** Deposits of $50+ / $100+ receive 5% / 10%\n extra balance, and an active partner promo code adds another 10%. One balance and\n one image/video history are shared between MCP and the website.\n\n## Registry\n\nPublished in the official [MCP Registry](https://github.com/modelcontextprotocol/registry)\nas **`pro.bananabanana/image-video`**. The canonical descriptor is\n[`server.json`](https://github.com/bananabanana-pro-mcp/bananabanana-mcp/blob/main/server.json). Look it up:\n\n```bash\ncurl -s \"https://registry.modelcontextprotocol.io/v0/servers?search=pro.bananabanana/image-video\"\n```\n\n## Links\n\n- **Website:** \n- **MCP docs & live example:** \n- **Create an API key:** \n- **Authentication** · [`docs/authentication.md`](https://github.com/bananabanana-pro-mcp/bananabanana-mcp/blob/main/docs/authentication.md)\n- **Tools reference** · [`docs/tools.md`](https://github.com/bananabanana-pro-mcp/bananabanana-mcp/blob/main/docs/tools.md)\n- **Pricing & limits** · [`docs/pricing.md`](https://github.com/bananabanana-pro-mcp/bananabanana-mcp/blob/main/docs/pricing.md)\n- **Troubleshooting** · [`docs/troubleshooting.md`](https://github.com/bananabanana-pro-mcp/bananabanana-mcp/blob/main/docs/troubleshooting.md)\n- **Support:** support@bananabanana.pro\n\n## License\n\n[Apache-2.0](https://github.com/bananabanana-pro-mcp/bananabanana-mcp/blob/main/LICENSE) © BananaBanana. This repository is public documentation only —\nit contains no server source code, keys, or secrets.\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"iconType","image","upstream",{"_111":112,"_113":114,"_115":-5,"_116":117,"_118":119,"_120":121},"requiredSecrets",[],"tags",[101,102,103,104,105,106,107,108,109,110],"assets",[],"stats",{"_99":86,"_100":86},"ratingAvg","reviewCount","ai","claude-code","cursor","image-generation","nano-banana","remote-mcp-server","text-to-image","text-to-video","veo","video-generation","topics",[101,102,103,104,122,123,124,105,106,107,108,109,110],"license","Apache-2.0","language","registryName","pro.bananabanana/image-video","homepage","https://bananabanana.pro/mcp","packages",[],"mcp","mcp-server","model-context-protocol","ENV",{"_127":128,"_129":130,"_131":132},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]

BananaBanana Image, Video & Speech Generation