Imaginode

Genera imágenes y videos con IA desde cualquier cliente MCP: 48 modelos con un solo saldo de créditos, costo conocido antes de la llamada, reembolso en caso de fallo.

GitHub

Documentación

Servidor MCP de Imaginode

Genera imágenes y videos con IA desde ChatGPT, Claude, Claude Code, Cursor o cualquier cliente MCP, impulsado por imaginode.ai, el estudio de creación de IA con lienzo de nodos.

89 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. El catálogo completo, con una página por modelo, está en imaginode.ai/models.
Inicia sesión, sin necesidad de pegar claves: el servidor utiliza OAuth 2.1. ChatGPT, Claude y Claude Code abren una página de Imaginode, inicias sesión y autorizas la aplicación. Las claves API también funcionan para scripts y clientes sin OAuth.
Plantillas incluidas: los flujos de trabajo curados del lienzo de Imaginode (sesiones de producto, renovaciones, efectos de video, libros infantiles, miniaturas…) se exponen como recetas, con el enlace que las abre listas para ejecutarse.
Precios transparentes: cada generación devuelve su costo exacto en créditos (1 crédito = $0.012, o €0.01 cuando se factura en euros) antes del resultado. Las generaciones fallidas se reembolsan automáticamente. Calcula el precio de una ejecución antes de realizarla con la calculadora de costos, que no requiere cuenta.
Servidor remoto, nada que instalar: https://imaginode.ai/api/mcp (HTTP Streamable).

Cuánto cuesta antes de llamarlo

La API devuelve el costo exacto de cada generación, pero a menudo quieres el número antes de escribir la llamada. Dos páginas públicas responden eso sin necesidad de cuenta:

Calculadora de costos: elige un modelo, una duración y una resolución, y lee el precio en créditos y en dólares.
GET /api/models: el mismo catálogo y precios en JSON legible por máquina, sin autenticación, para que un cliente pueda construir su propia estimación.

Inicio rápido

Crea una cuenta gratuita en imaginode.ai (créditos de prueba incluidos, se requiere correo verificado).
Conecta tu cliente. Guía completa por asistente: imaginode.ai/mcp.

ChatGPT: Configuración, Aplicaciones y conectores, Crear: pega https://imaginode.ai/api/mcp, elige OAuth, inicia sesión en tu cuenta de Imaginode.

Claude.ai / Claude Desktop: Configuración, Conectores, Agregar conector personalizado: pega https://imaginode.ai/api/mcp e inicia sesión cuando Claude lo solicite.

Claude Code (el inicio de sesión se abre en tu navegador en el primer uso):

claude mcp add --transport http imaginode https://imaginode.ai/api/mcp

Cursor (.cursor/mcp.json, OAuth):

{
  "mcpServers": {
    "imaginode": { "url": "https://imaginode.ai/api/mcp" }
  }
}

Con una clave API en su lugar (scripts, clientes sin OAuth): crea una clave en tu perfil, sección Claves API, y envíala como encabezado:

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

Luego solo pídele a tu asistente: "Genera una imagen cinematográfica de un zorro rojo en un bosque brumoso", "Haz un video de 5 segundos de olas del océano al atardecer" o "¿Qué plantilla de Imaginode convierte mi selfie en una figura coleccionable?".

Herramientas

Herramienta	Qué hace
`list_models`	Catálogo de modelos de imagen y video con precios en créditos y opciones facturables.
`list_templates`	Las plantillas curadas del lienzo: qué produce cada una, sus modelos, el costo aproximado de una ejecución.
`get_template`	Receta completa de una plantilla (nodos, modelos, prompts, conexiones, renders de ejemplo) y el enlace que la abre en el lienzo.
`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.

Detalles de OAuth (para autores de clientes)

Descubrimiento: https://imaginode.ai/.well-known/oauth-authorization-server y https://imaginode.ai/.well-known/oauth-protected-resource.
Código de autorización con PKCE (S256) y tokens de actualización (rotados). Se admiten tanto el registro dinámico de clientes (RFC 7591) como los Documentos de Metadatos de ID de Cliente; las URIs de redirección pueden ser https, http de bucle local o un esquema de aplicación privada.
Alcance: generate. Una solicitud no autenticada recibe un 401 con WWW-Authenticate: Bearer resource_metadata="…".
Las aplicaciones conectadas pueden revocarse por el usuario desde su perfil, y por el cliente a través del endpoint de revocación (RFC 7009).

API REST directa

El servidor MCP es una fachada delgada sobre tres endpoints públicos que también puedes llamar desde cualquier script (clave API o token de acceso OAuth en el encabezado Authorization):

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 API son secretos personales: se muestran una vez, se pueden revocar al instante desde tu perfil, máximo 5 claves activas.
Cada clave, y cada token de acceso OAuth, tiene un límite de 10 generaciones por minuto.
Los tokens de acceso OAuth duran una hora y se renuevan silenciosamente; una aplicación conectada puede desconectarse en cualquier momento desde el perfil, en Aplicaciones conectadas.
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.