Imaginode

Gere imagens e vídeos com IA a partir de qualquer cliente MCP: 48 modelos em um único saldo de créditos, custo conhecido antes da chamada, reembolsado em caso de falha.

GitHub

Documentação

Servidor MCP Imaginode

Gere imagens e vídeos com IA a partir do ChatGPT, Claude, Claude Code, Cursor ou qualquer cliente MCP, com tecnologia de imaginode.ai, o estúdio de criação de IA em node-canvas.

89 modelos em uma única conta: Flux 2, Nano Banana 2, Seedream 5, GPT Image, Kling V3, Seedance 2.5, Veo 3.1, Hailuo, Wan e muito mais. O catálogo completo, com uma página por modelo, está em imaginode.ai/models.
Faça login, sem necessidade de colar chave: o servidor fala OAuth 2.1. ChatGPT, Claude e Claude Code abrem uma página da Imaginode, você faz login e autoriza o aplicativo. Chaves de API continuam funcionando para scripts e clientes sem OAuth.
Modelos incluídos: os fluxos de trabalho selecionados do canvas Imaginode (ensaios de produtos, reformas, efeitos de vídeo, livros infantis, miniaturas…) são expostos como receitas, com o link que as abre pronto para execução.
Preços transparentes: cada geração retorna seu custo exato em créditos (1 crédito = $0,012, ou €0,01 quando cobrado em euros) antes do resultado. Gerações com falha são reembolsadas automaticamente. Calcule o preço de uma execução antes de fazê-la com a calculadora de custos, que não exige conta.
Servidor remoto, nada para instalar: https://imaginode.ai/api/mcp (HTTP Streamable).

Quanto custa antes de você chamar

A API retorna o custo exato de cada geração, mas muitas vezes você quer o número antes de escrever a chamada. Duas páginas públicas respondem a isso sem conta:

Calculadora de custos: escolha um modelo, uma duração e uma resolução, leia o preço em créditos e em dólares.
GET /api/models: o mesmo catálogo e preços em JSON legível por máquina, sem autenticação, para que um cliente possa criar sua própria estimativa.

Início rápido

Crie uma conta gratuita em imaginode.ai (créditos de teste incluídos, e-mail verificado obrigatório).
Conecte seu cliente. Guia completo por assistente: imaginode.ai/mcp.

ChatGPT: Configurações, Aplicativos e conectores, Criar: cole https://imaginode.ai/api/mcp, escolha OAuth, faça login na sua conta Imaginode.

Claude.ai / Claude Desktop: Configurações, Conectores, Adicionar conector personalizado: cole https://imaginode.ai/api/mcp e faça login quando o Claude solicitar.

Claude Code (o login abre no seu navegador no primeiro 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" }
  }
}

Com uma chave de API em vez disso (scripts, clientes sem OAuth): crie uma chave em seu perfil, seção Chaves de API, e envie-a como cabeçalho:

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

Depois, basta pedir ao seu assistente: "Gere uma imagem cinematográfica de uma raposa vermelha em uma floresta enevoada", "Faça um vídeo de 5 segundos de ondas do mar ao pôr do sol" ou "Qual modelo Imaginode transforma minha selfie em uma estatueta colecionável?".

Ferramentas

Ferramenta	O que faz
`list_models`	Catálogo de modelos de imagem e vídeo com preços em créditos e opções faturáveis.
`list_templates`	Os modelos selecionados do canvas: o que cada um produz, seus modelos, o custo aproximado de uma execução.
`get_template`	Receita completa de um modelo (nós, modelos, prompts, conexões, exemplos de renderização) e o link que o abre no canvas.
`generate_image`	Gera uma imagem e aguarda o resultado: a URL é retornada diretamente. Modelo padrão: Nano Banana 2.
`generate_video`	Inicia uma geração de vídeo e retorna um `request_id` mais o custo exato. Modelo padrão: Seedance 2.0.
`get_generation_status`	Acompanha uma geração (`running`, `completed` com URLs de saída, ou `failed` com reembolso automático).

Vídeos normalmente levam de 1 a 5 minutos (até 30 para trabalhos longos): consulte get_generation_status a cada 30 segundos.

Detalhes do OAuth (para autores de clientes)

Descoberta: https://imaginode.ai/.well-known/oauth-authorization-server e https://imaginode.ai/.well-known/oauth-protected-resource.
Código de autorização com PKCE (S256) e tokens de atualização (rotacionados). Registro dinâmico de clientes (RFC 7591) e Documentos de Metadados de ID de Cliente são suportados; URIs de redirecionamento podem ser https, http de loopback ou um esquema de aplicativo privado.
Escopo: generate. Uma solicitação não autenticada recebe um 401 com WWW-Authenticate: Bearer resource_metadata="…".
Aplicativos conectados podem ser revogados pelo usuário em seu perfil, e pelo cliente por meio do endpoint de revogação (RFC 7009).

API REST direta

O servidor MCP é uma fachada fina sobre três endpoints públicos que você também pode chamar de qualquer script (chave de API ou token de acesso OAuth no cabeçalho Authorization):

GET https://imaginode.ai/api/models: catálogo de modelos e preços, sem autenticação.
POST https://imaginode.ai/api/generate: corpo { "model", "prompt", "duration", "resolution", "aspectRatio", "audio", "imageUrls" }, cabeçalho Authorization: Bearer imk_…. Retorna { requestId, cost, balance }.
GET https://imaginode.ai/api/generate/status?requestId=…: retorna running, completed (com outputUrls) ou failed (reembolsado).

As imagens de entrada devem ser mídias hospedadas na sua conta Imaginode (biblioteca de mídia ou gerações anteriores).

Documentação completa: imaginode.ai/docs/api-mcp.

Limites e segurança

Chaves de API são segredos pessoais: mostradas uma vez, revogáveis instantaneamente no seu perfil, máximo de 5 chaves ativas.
Cada chave e cada token de acesso OAuth tem limite de 10 gerações por minuto.
Tokens de acesso OAuth duram uma hora e são renovados silenciosamente; um aplicativo conectado pode ser desconectado a qualquer momento no perfil, em Aplicativos conectados.
Cada chamada gasta os créditos da sua própria conta, aos mesmos preços do canvas; você nunca pode gastar além do seu saldo, e falhas são reembolsadas.

Habilidade do Claude

A pasta skills/imaginode contém uma habilidade opcional do Claude Code que ensina o Claude a usar bem este servidor (iteração priorizando modelos baratos, consciência de custos, cadência de consultas). Instale copiando a pasta para ~/.claude/skills/imaginode.

Licença

MIT. O servidor em si roda em imaginode.ai; este repositório hospeda seu manifesto público, documentação e habilidade.