Bananabanana MCP Server

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 key
• Website: 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.pro

Claude 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).

Tools

Ten tools; the read-only and account-access tools are free. Full reference in docs/tools.md.

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.

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_models returns 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_key bound 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.md
• Authentication · docs/authentication.md
• Tools reference · docs/tools.md
• Pricing & limits · docs/pricing.md
• Troubleshooting · docs/troubleshooting.md
• Support: support@bananabanana.pro

License

Apache-2.0 © BananaBanana. This repository is public documentation only — it contains no server source code, keys, or secrets.