BananaBanana MCP Server

A remote Model Context Protocol server exposing the full BananaBanana generation stack as agent tools: Google Nano Banana 2 Lite / 2 / Pro images (from $0.03), Veo 3.1 / Fast / Lite video and Gemini Omni Flash with sound (flat $1.00). Your agent sees live prices, confirms costs before expensive runs, and every generation lands in the same history and balance as the website.

• Endpoint: https://bananabanana.pro/api/mcp (Streamable HTTP)
• Auth: Bearer API key from your profile (OAuth 2.1 support is planned)
• Rate limit: 20 tool calls per minute per key; optional per-key daily spend cap
• Failed or filtered generations are refunded automatically

1. Create an account and top up the balance. 2. In Profile → MCP API Keys create a key (shown once). 3. Add the server to your client:

Claude Code

claude mcp add --transport http bananabanana https://bananabanana.pro/api/mcp \
  --header "Authorization: Bearer bb_live_YOUR_KEY"

Claude Desktop

Add to claude_desktop_config.json (Settings → Developer → Edit Config); requires Node.js for the mcp-remote bridge:

{
  "mcpServers": {
    "bananabanana": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://bananabanana.pro/api/mcp",
        "--header", "Authorization: Bearer bb_live_YOUR_KEY"
      ]
    }
  }
}

Any MCP client

POST https://bananabanana.pro/api/mcp
Authorization: Bearer bb_live_YOUR_KEY
Content-Type: application/json
Accept: application/json, text/event-stream

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

Prefer a walkthrough? The tutorial Generate Images in Claude Code covers setup for Claude Code, Claude Desktop, Gemini CLI and ZCode, with four real use cases and their actual costs.

• Prices are served live by list_models — the same source the website uses.
• Every video (and multi-image batch) call first returns a quote and charges nothing; the agent repeats the call with confirm_cost to start.
• Every result includes cost_charged_usd and balance_remaining_usd.
• Upstream failures and content-filter rejections are refunded automatically — same policy as the web app.
• Optional idempotency_key guarantees retries never double-charge.

→ generate_video {"prompt": "drone shot over a misty pine forest", "model": "veo-3.1-fast"}
← {"status": "confirmation_required", "quoted_cost_usd": 0.70, ...}
→ generate_video {..., "confirm_cost": 0.70}
← {"job_id": "cmxy…", "status": "processing", "cost_charged_usd": 0.70, "balance_remaining_usd": 12.40}
→ get_result {"job_id": "cmxy…"}
← {"status": "completed", "files": [{"url": "https://…"}], "cost_charged_usd": 0.70}

• Result URLs are signed and valid for 24 hours; the media itself stays in your account — call get_result again for fresh links, or download from the website.
• API keys are stored hashed and shown only once at creation; revoke them any time in your profile.
• Per-key usage log (tool, model, cost, prompt preview) is visible in Profile → MCP API Keys.
• MCP generations appear in the same generation history and analytics as web generations.