Skip to main content
Glama

BananaBanana MCP Server

Un servidor MCP para la generación de imágenes, vídeos y voz —modelos Nano Banana, Veo, Omni y Gemini TTS de Google— que permite a cualquier cliente MCP (Claude Code, Claude Desktop, Cursor y otros) crear contenido multimedia de pago por uso con pagos en criptomonedas y sin suscripción.

Genera imágenes desde $0,03, vídeos desde $0,10 y voz por $0,01 por cada 200 caracteres de transcripción empezados, con cargo a un saldo de cuenta que recargas con criptomonedas. Presupuesto de coste antes de cada llamada costosa, reembolsos automáticos en caso de error y un historial de imágenes/vídeos compartido con el sitio web.

Inicio rápido

OAuth es la vía de conexión principal. Las claves de API siguen disponibles para clientes sin OAuth y para scripts o CI:

  • OAuth 2.1 (claude.ai, Claude Desktop, Claude mobile, Claude Code, MCP Inspector): añade un conector personalizado con la URL anterior, pulsa Connect y aprueba el acceso. No hay ninguna clave que copiar. Consulta docs/authentication.md.

  • Clave de API (Cursor, VS Code, Windsurf, Codex, scripts, CI): crea una clave en tu perfil — https://bananabanana.pro/profile, sección API Keys — e indícala en la configuración del cliente como se muestra a continuación.

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

Usa Settings → Connectors → Add custom connector e introduce https://bananabanana.pro/api/mcp; luego pulsa Connect y aprueba el acceso. Si tu versión de Desktop usa claude_desktop_config.json, el puente mcp-remote compatible con OAuth requiere Node.js:

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

El puente abre el flujo de inicio de sesión OAuth en el primer uso. Consulta docs/authentication.md para la alternativa con clave de API.

Cursor — ~/.cursor/mcp.json (global) o .cursor/mcp.json (proyecto):

{
  "mcpServers": {
    "bananabanana": {
      "url": "https://bananabanana.pro/api/mcp",
      "headers": { "Authorization": "Bearer bb_live_YOUR_KEY" }
    }
  }
}

VS Code — .vscode/mcp.json (guarda la clave como un prompt cifrado):

{
  "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" }
    }
  }
}

Las configuraciones listas para copiar están en examples/. Una vez conectado, pide a tu agente que ejecute list_models (gratis); devuelve la lista de modelos en vivo y los precios.

¿No tienes un cliente MCP? El servidor es JSON-RPC puro sobre HTTPS: puedes llamarlo desde curl, Python o TypeScript sin SDK: examples/no-sdk.md (scripts ejecutables: generate.py, generate.mjs).

Related MCP server: Nanana AI Image Generation Server

Herramientas

Nueve herramientas; las de solo lectura son gratuitas. Referencia completa en docs/tools.md.

Tool

What it does

Key parameters

list_models

Enumera los modelos con precios en USD en vivo, resoluciones, duraciones y restricciones. Gratis.

—

get_account

Saldo, nombre de la clave, límite diario, gasto de hoy. Gratis.

—

generate_image

Texto a imagen (Nano Banana 2 Lite / 2 / Pro), hasta 4K, 1–4 variantes. Devuelve un job_id.

prompt, model, aspect_ratio, resolution, number_of_images, confirm_cost

edit_image

Edición en varios turnos de una imagen terminada mediante instrucciones de texto.

source_generation_id, prompt, model, resolution

generate_video

Vídeo (familia Veo 3.1 u Omni Flash), opcionalmente a partir de un fotograma inicial e imágenes de referencia. Siempre presupuesta primero. Devuelve un job_id.

prompt, model, duration, resolution, with_audio, first_frame, reference_images, confirm_cost

edit_video

Edición de vídeo a vídeo en Omni Flash: reestilizar, reemplazar objetos, cambiar la iluminación de un clip existente. Siempre presupuesta primero.

prompt, source_generation_id o video_url, duration, audio_prompt, confirm_cost

generate_speech

Voz con Gemini 3.1 Flash TTS: un locutor o un diálogo de dos locutores. Devuelve una URL WAV alojada de forma síncrona.

text, voice, language_code, style, speakers

get_result

Consulta un trabajo; devuelve las URLs de medios alojados (24 h) + coste/saldo. Gratis.

job_id, wait_seconds

list_generations

Historial reciente de la cuenta (compartido con el sitio web). Gratis.

limit, type, status

La generación de imágenes y vídeos es asíncrona: las llamadas de generación/edición devuelven un job_id; consulta get_result para obtener el contenido. generate_speech es síncrona y devuelve su URL WAV directamente. generate_video, edit_video y generate_image con varias imágenes presupuestan primero y no cobran nada hasta que repitas la llamada con confirm_cost.

Precios

Pago por uso en USD: por imagen, por clip de Veo, por segundo en Omni Flash y por cada 200 caracteres de transcripción empezados en el caso de la voz. Las cifras en vivo provienen de list_models; tablas completas en docs/pricing.md.

Model

Type

Price

nano-banana-2-lite

Imagen (1024)

$0,03

nano-banana-2

Imagen (512→4096)

$0,03 – $0,13

nano-banana-pro

Imagen (1024→4096)

$0,11 – $0,20

veo-3.1-lite

Vídeo (720p/1080p; 4, 6 u 8 s)

$0,10 – $0,56

veo-3.1-fast

Vídeo (hasta 4K; 4, 6 u 8 s)

$0,35 – $2,60

veo-3.1

Vídeo (hasta 4K; 4, 6 u 8 s)

$0,70 – $4,40

omni-flash

Vídeo (720p, sonido, 3–10 s)

$0,10 / s ($0,30 – $1,00)

gemini-3.1-flash-tts-preview

Voz (WAV)

$0,01 / cada 200 caracteres de transcripción empezados

Las imágenes cuestan $0,03–$0,20 cada una; el vídeo cuesta $0,10–$4,40 por clip, con Omni Flash facturado a $0,10/s. La generación con Veo acepta 4, 6 u 8 segundos; los precios de 7 segundos devueltos por list_models corresponden a trabajos de extensión, no a una duración seleccionable de generate_video. Lecturas gratuitas: list_models, get_account, get_result, list_generations. Las generaciones fallidas o filtradas por contenido se reembolsan automáticamente.

Las bonificaciones por recarga pueden reducir el coste efectivo: los depósitos de $50+ reciben un 5% extra de saldo, los de $100+ reciben un 10%, y un código promocional de socio activo añade otro 10%. Las bonificaciones son acumulables. La tabla muestra los cargos nominales de generación; el coste efectivo para ti depende de la bonificación por recarga.

Por qué esto en lugar de un servicio de suscripción

  • Pagas solo por lo que generas: nada más. Sin cuota mensual, sin licencias por usuario, sin créditos que caduquen. Un mes tranquilo cuesta $0; el saldo que recargas es el único gasto.

  • El agente ve el precio antes de gastar. list_models devuelve precios en vivo, y las llamadas de vídeo / lote devuelven un presupuesto y no cobran nada hasta que se confirma, así que un agente no puede generar una factura sorpresa.

  • Los fallos no te cuestan. Los errores de proveedor y los rechazos por filtrado de contenido se reembolsan automáticamente; los límites diarios opcionales por clave e idempotency_key acotan aún más el riesgo.

  • Recargas con cripto, sin necesidad de tarjeta. Los depósitos de $50+ / $100+ reciben un 5% / 10% extra de saldo, y un código promocional de socio activo añade otro 10%. Un único saldo y un único historial de imágenes/vídeos se comparten entre MCP y el sitio web.

Registro

Publicado en el MCP Registry oficial como pro.bananabanana/image-video. El descriptor canónico es server.json. Búscalo:

curl -s "https://registry.modelcontextprotocol.io/v0/servers?search=pro.bananabanana/image-video"

Enlaces

Licencia

Apache-2.0 © BananaBanana. Este repositorio es solo documentación pública: no contiene código fuente del servidor, claves ni secretos.

Related MCP Connectors

Related MCP Servers