Imaginode

Servidor MCP de Imaginode

Genera imágenes y videos con IA desde Claude, Cursor o cualquier cliente MCP, impulsado por imaginode.ai, el estudio de creación de IA basado en node-canvas.

• Más de 48 modelos en una sola cuenta: Flux 2, Nano Banana 2, Seedream 5, GPT Image, Kling V3, Seedance 2.5, Veo 3.1, Hailuo, Wan y más.
• Precios transparentes: cada generación devuelve su costo exacto en créditos (1 crédito = €0.01) antes del resultado. Las generaciones fallidas se reembolsan automáticamente.
• Servidor remoto, nada que instalar: https://imaginode.ai/api/mcp (HTTP Streamable).

Inicio rápido

1. Crea una cuenta gratuita en imaginode.ai (se incluyen créditos de prueba, se requiere correo verificado).
2. Crea una clave de API en tu perfil, sección Claves de API. El secreto imk_… se muestra una sola vez.
3. Conecta tu cliente:

Claude Code

claude mcp add --transport http imaginode https://imaginode.ai/api/mcp --header "Authorization: Bearer imk_YOUR_KEY"

Claude.ai / Claude Desktop: agrega un conector personalizado con la URL https://imaginode.ai/api/mcp y el mismo encabezado Authorization.

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "imaginode": {
      "url": "https://imaginode.ai/api/mcp",
      "headers": { "Authorization": "Bearer imk_YOUR_KEY" }
    }
  }
}

Luego solo pídele a tu asistente: "Genera una imagen cinematográfica de un zorro rojo en un bosque neblinoso" o "Haz un video de 5 segundos de olas del océano al atardecer".

Herramientas

Herramienta	Qué hace
list_models	Catálogo de modelos de imagen y video con precios en créditos y opciones facturables.
generate_image	Genera una imagen y espera el resultado: la URL se devuelve directamente. Modelo predeterminado: Nano Banana 2.
generate_video	Inicia una generación de video y devuelve un request_id más el costo exacto. Modelo predeterminado: Seedance 2.0.
get_generation_status	Da seguimiento a una generación (running, completed con URLs de salida, o failed con reembolso automático).

Los videos suelen tardar de 1 a 5 minutos (hasta 30 para trabajos largos): consulta get_generation_status cada 30 segundos.

API REST directa

El servidor MCP es una fachada ligera sobre tres endpoints públicos que también puedes llamar desde cualquier script:

• GET https://imaginode.ai/api/models: catálogo de modelos y precios, sin autenticación.
• POST https://imaginode.ai/api/generate: cuerpo { "model", "prompt", "duration", "resolution", "aspectRatio", "audio", "imageUrls" }, encabezado Authorization: Bearer imk_…. Devuelve { requestId, cost, balance }.
• GET https://imaginode.ai/api/generate/status?requestId=…: devuelve running, completed (con outputUrls) o failed (reembolsado).

Las imágenes de entrada deben ser medios alojados en tu cuenta de Imaginode (biblioteca de medios o generaciones anteriores).

Documentación completa: imaginode.ai/docs/api-mcp.

Límites y seguridad

• Las claves de API son secretos personales: se muestran una sola vez, se pueden revocar al instante desde tu perfil, máximo 5 claves activas.
• Cada clave está limitada a 10 generaciones por minuto.
• Cada llamada gasta los créditos de tu propia cuenta, a los mismos precios que el lienzo; nunca puedes gastar más allá de tu saldo, y los fallos se reembolsan.

Habilidad de Claude

La carpeta skills/imaginode contiene una habilidad opcional de Claude Code que enseña a Claude a usar bien este servidor (iteración priorizando modelos baratos, conciencia de costos, cadencia de consultas). Instálala copiando la carpeta a ~/.claude/skills/imaginode.

Licencia

MIT. El servidor en sí se ejecuta en imaginode.ai; este repositorio aloja su manifiesto público, documentación y habilidad.