EmpirioLabs AI

npx add-mcp 'https://mcp.empiriolabs.ai/mcp'

Para Markdown limpo de qualquer página, adicione .md ao final da URL da página. Para um índice completo da documentação, consulte https://docs.empiriolabs.ai/llms.txt. Para integração com clientes de IA (Claude Code, Cursor, etc.), conecte-se ao servidor MCP em https://docs.empiriolabs.ai/_mcp/server.

Servidor MCP

O servidor MCP da EmpirioLabs permite que qualquer cliente do Model Context Protocol execute toda a plataforma como ferramentas: converse com todos os modelos de texto, gere imagens, vídeo, áudio, fala, 3D e transcrições, execute pesquisa e investigação na web, gerencie trabalhos, lotes, GPU Cloud e agentes hospedados, e leia seu uso e saldo. É um servidor remoto, então não há nada para instalar.

URL do servidor

https://mcp.empiriolabs.ai/mcp (HTTP Streamable). Perfis como /mcp/inference expõem um subconjunto de ferramentas.

Entre ou use uma chave

Claude e ChatGPT fazem seu login com OAuth. Ferramentas de codificação e scripts podem enviar uma chave de API da EmpirioLabs como token de portador.

Sempre atualizado

Cada modelo e recurso que a EmpirioLabs adiciona está disponível aqui no lançamento, com os mesmos preços finais e limites da API.

Seus créditos, seus controles

As conexões usam seus créditos. Veja e desconecte qualquer aplicativo conectado em Configurações no painel.

Conectar

Claude (web, desktop, mobile)

1. Abra Configurações, depois Conectores, e escolha Adicionar conector personalizado.
2. Insira https://mcp.empiriolabs.ai/mcp como a URL. Deixe os campos do cliente OAuth vazios.
3. Clique em Conectar, faça login na EmpirioLabs, revise a solicitação e escolha Permitir acesso.

O Claude Code usa o mesmo servidor:

claude mcp add --transport http empiriolabs https://mcp.empiriolabs.ai/mcp

Execute /mcp dentro do Claude Code para concluir o login na primeira vez.

ChatGPT

1. Abra Configurações, depois Conectores (ou Apps), e habilite Modo desenvolvedor em Avançado.
2. Escolha Criar e insira https://mcp.empiriolabs.ai/mcp como a URL do servidor MCP com autenticação OAuth.
3. Conclua o login e escolha Permitir acesso. O servidor também fornece as ferramentas search e fetch que o ChatGPT usa para conectores, então funciona no chat e em pesquisa profunda.

Cursor, VS Code, Windsurf e outros editores

Servidores remotos são configurados com uma URL. Faça login via OAuth quando o editor solicitar, ou adicione um cabeçalho de chave de API:

{
  "mcpServers": {
    "empiriolabs": {
      "url": "https://mcp.empiriolabs.ai/mcp",
      "headers": {
        "Authorization": "Bearer sk-empiriolabs-your_key_here"
      }
    }
  }
}

O VS Code lê o mesmo formato de .vscode/mcp.json com uma chave servers e "type": "http". Codex CLI: codex mcp add empiriolabs --url https://mcp.empiriolabs.ai/mcp. Gemini CLI e Windsurf aceitam o bloco JSON acima nas configurações de MCP.

Qualquer cliente HTTP

O servidor fala JSON-RPC sobre POST https://mcp.empiriolabs.ai/mcp e responde com JSON. Envie Authorization: Bearer <API key or OAuth access token> e Accept: application/json, text/event-stream em cada solicitação.

curl "https://mcp.empiriolabs.ai/mcp" \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_models","arguments":{"modality":"image","limit":5}}}'

Como o acesso funciona

• Login OAuth. Claude, ChatGPT e outros clientes OAuth abrem um login da EmpirioLabs. Você aprova a solicitação no painel e o aplicativo é conectado; ele recebe tokens de curta duração e os renova por conta própria. Clientes que precisam podem descobrir o login através dos metadados padrão de recursos em https://mcp.empiriolabs.ai/.well-known/oauth-protected-resource.
• Chave de API. Envie qualquer chave de API ativa da EmpirioLabs como token de portador para obter todas as ferramentas sem etapa de login. Isso é adequado para editores, scripts e servidores que você controla.
• Desconexão. Abra Configurações no painel e desconecte o aplicativo em Aplicativos conectados; ele perde o acesso imediatamente e pede que você faça login novamente na próxima vez que usá-lo. Os aplicativos também podem se desconectar através do endpoint padrão de revogação.
• Escopos. Cada conjunto de ferramentas abaixo também é um escopo OAuth, então um aplicativo pode solicitar apenas o que precisa e a tela de consentimento mostra exatamente o que você está concedendo.

Perfis

Cada conjunto de ferramentas está disponível em https://mcp.empiriolabs.ai/mcp. Adicione um perfil ou uma lista de conjuntos de ferramentas separada por + ao caminho para expor uma lista de ferramentas menor e mais focada, por exemplo, quando um cliente funciona melhor com menos ferramentas ou quando você quer uma conexão que não pode gerar mídia.

Trabalhos e geração de longa duração

Ferramentas de imagem, vídeo, áudio, transcrição, 3D, Compose e agentes retornam URLs de saída concluídas quando o trabalho termina dentro da janela de espera (padrão 40 segundos, no máximo 50). Caso contrário, retornam um job_id e o cliente deve chamar get_job, que também pode esperar, em vez de iniciar a geração novamente. As URLs de saída são assinadas e expiram, então baixe qualquer coisa que queira manter. Ferramentas de chat, pesquisa e investigação respondem inline.

Exemplos de prompts

• "Liste os modelos de vídeo mais baratos na EmpirioLabs, depois gere um clipe de 5 segundos de ondas ao pôr do sol com o de melhor custo-benefício."
• "Use a EmpirioLabs para transcrever esta gravação, depois resuma os itens de ação com qwen3-7-max."
• "Verifique meu saldo na EmpirioLabs e mostre o que gastei em geração de imagens esta semana."
• "Implante um H100 na GPU Cloud da EmpirioLabs com o template vLLM e me avise quando estiver pronto."
• "Execute uma tarefa de pesquisa na web sobre as últimas mudanças na especificação MCP e cite fontes."

Preços, limites e erros

As ferramentas usam os mesmos preços finais de Modelos e Preços, os mesmos limites de conta de Limites e Chaves de API e as mesmas mensagens de erro de Erros e Códigos de Status. Um resultado de ferramenta com isError carrega a mesma mensagem acionável que a API retorna, por exemplo, quando um modelo não suporta o endpoint solicitado ou quando a conta precisa de créditos.

Privacidade

Prompts e saídas não são armazenados para inspeção. Registros de uso mantêm apenas metadados como modelo, tokens, custo e status. Consulte a Política de Privacidade e Suporte.

Referência de ferramentas

As ferramentas são agrupadas por conjunto de ferramentas. Um conjunto de ferramentas também é o escopo que um aplicativo solicita ao se conectar, então a tela de consentimento e esta referência usam os mesmos nomes.

Conjuntos de ferramentas e escopos

Conjunto de ferramentas (escopo OAuth)	O que permite	Ferramentas
models	Navegue pelo catálogo de modelos, preços, capacidades e parâmetros	5
text	Execute chat, embeddings, reranking e detecção de texto de IA (usa créditos)	4
search	Execute pesquisa na web, respostas fundamentadas e investigação (usa créditos)	3
media	Gere e edite imagens, vídeo, áudio, fala, transcrição e 3D (usa créditos)	13
jobs	Verifique, aguarde e cancele trabalhos de geração	3
agents	Execute e gerencie tarefas de agentes (usa créditos)	4
account	Leia o histórico de uso e o saldo atual	1
batch	Envie arquivos em lote e gerencie trabalhos em lote (usa créditos)	6
gpu	Implante e gerencie instâncias de GPU, clusters e volumes (cobrável)	16
hosted_agents	Crie e gerencie agentes hospedados (cobrável)	23

Perfis

URL	Conjuntos de ferramentas
https://mcp.empiriolabs.ai/mcp	todos os conjuntos de ferramentas
https://mcp.empiriolabs.ai/mcp/inference	models, text, search, jobs, account
https://mcp.empiriolabs.ai/mcp/media	models, media, jobs, account
https://mcp.empiriolabs.ai/mcp/cloud	models, account, gpu, hosted_agents
https://mcp.empiriolabs.ai/mcp/no-media	models, text, search, jobs, agents, account, batch, gpu, hosted_agents

Combine conjuntos de ferramentas ou perfis com +, por exemplo https://mcp.empiriolabs.ai/mcp/models+text+jobs.

Ferramentas models

Ferramenta	Descrição	Acesso
list_models	Liste modelos da EmpirioLabs com provedor, modalidade, endpoints e preços finais. Filtre por consulta de texto livre, modalidade (texto, imagem, vídeo, áudio, multimodal, 3D), categoria, provedor ou caminho de endpoint. Chame isso antes de escolher um id de modelo.	somente leitura
get_model	Obtenha o esquema completo de um modelo: descrição, endpoints, janela de contexto, preços finais, notas e cada parâmetro suportado com padrões e intervalos.	somente leitura
search	Pesquise o catálogo de modelos e a documentação da EmpirioLabs. Retorna ids de resultado para fetch: model: para um modelo, doc: para uma página de documentação.	somente leitura
fetch	Busque o texto completo de um resultado de pesquisa por id (model: ou doc:).	somente leitura
get_platform_status	Verifique se a API da EmpirioLabs e seus modelos estão atualmente no ar, com disponibilidade por modelo.	somente leitura

Ferramentas text

Ferramenta	Descrição	Acesso
chat	Execute uma conclusão de chat em qualquer modelo de chat da EmpirioLabs e retorne a resposta do assistente, raciocínio (quando o modelo expõe), chamadas de ferramenta e uso de tokens. Usa créditos.	escrita
embeddings	Crie vetores de embedding para um ou mais textos com um modelo de embedding. Usa créditos.	escrita
rerank	Pontue e reordene documentos por relevância a uma consulta com um modelo de reranking. Usa créditos.	escrita
detect_ai_text	Classifique se o texto foi escrito por um modelo de IA (GPTZero). Usa créditos.	escrita

Ferramentas search

Ferramenta	Descrição	Acesso
web_search	Execute uma pesquisa web ao vivo por meio de um modelo de busca (por exemplo, exa-search, tavily-search, linkup-search). Retorna resultados com títulos, URLs e trechos. Usa créditos.	write
web_research	Execute uma tarefa de pesquisa em várias etapas com citações (por exemplo, tavily-research, exa-research, linkup-deep-search). Leva até alguns minutos. Usa créditos.	write
web_answer	Obtenha uma resposta única com citações de um modelo de resposta fundamentado (por exemplo, exa-answer). Usa créditos.	write

Ferramentas media

Ferramenta	Descrição	Acesso
generate_image	Gere imagens a partir de um prompt (ou um modelo de geração) com um modelo de imagem. Retorna URLs de saída assinadas, ou um job_id para consultar com get_job quando a geração demorar mais que a espera. Usa créditos.	write
generate_video	Gere um vídeo a partir de um prompt, uma imagem ou um modelo de efeito criativo com um modelo de vídeo. O vídeo leva minutos: a ferramenta retorna um job_id e você deve consultar get_job até que a URL de saída assinada esteja pronta. Usa créditos.	write
list_generation_templates	Liste modelos de geração de imagem e vídeo curados (efeitos criativos) com seu slug, modalidade, modelo recomendado e entradas.	read-only
get_generation_template	Obtenha um modelo de geração por slug, incluindo orientação de prompt, modelo recomendado e parâmetros padrão.	read-only
list_compose_recipes	Liste as receitas Compose que encadeiam script, visuais, voz e música em um vídeo finalizado, com seus modos e entradas.	read-only
compose_video	Crie um vídeo finalizado a partir de uma receita Compose (briefing, script, storyboard ou edições). Retorna um job_id para consultar com get_job. Usa créditos.	write
generate_3d	Gere um modelo 3D a partir de uma imagem com um modelo de geração 3D (por exemplo, trellis-2-4b). Retorna um job_id para consultar com get_job. Usa créditos.	write
text_to_speech	Sintetize fala a partir de texto com um modelo TTS e voz. Retorna uma URL de áudio assinada (ou áudio inline). Usa créditos.	write
list_voices	Liste as vozes disponíveis para texto-para-fala, filtráveis por modelo, idioma, gênero ou texto de busca.	read-only
generate_audio	Gere música ou efeitos sonoros a partir de um prompt com um modelo de geração de áudio (por exemplo, ace-step-1-5-xl). Retorna uma URL assinada ou um job_id para get_job. Usa créditos.	write
transcribe_audio	Transcreva um arquivo de áudio ou vídeo em uma URL https com um modelo de fala-para-texto. Retorna a transcrição ou um job_id para get_job. Usa créditos.	write
analyze_image	Faça uma pergunta sobre uma imagem com um modelo com capacidade de visão e obtenha uma resposta em texto. Usa créditos.	write
edit_image	Edite uma imagem existente com uma instrução usando um modelo de edição de imagem. Retorna URLs de saída assinadas ou um job_id para get_job. Usa créditos.	write

Ferramentas jobs

Ferramenta	Descrição	Acesso
list_jobs	Liste os trabalhos assíncronos recentes da conta, do mais novo ao mais antigo.	read-only
get_job	Obtenha o status e o resultado de um trabalho de geração assíncrono. Opcionalmente, aguarde até wait_seconds para que ele termine. Nunca reinicie um trabalho que ainda está em processamento.	read-only
cancel_job	Cancele um trabalho na fila ou em processamento. Trabalhos concluídos são retornados inalterados.	destructive

Ferramentas agents

Ferramenta	Descrição	Acesso
run_agent_task	Inicie uma tarefa de agente de longa duração (por exemplo, com o modelo manus) ou envie uma mensagem de acompanhamento para uma tarefa existente. Retorna um job_id para get_job e o task_id para get_agent_task. Usa créditos.	write
get_agent_task	Obtenha o status e a saída de uma tarefa de agente.	read-only
get_agent_task_messages	Liste as mensagens trocadas durante uma tarefa de agente.	read-only
stop_agent_task	Pare uma tarefa de agente em execução.	destructive

Ferramentas account

Ferramenta	Descrição	Acesso
get_account_usage	Leia o saldo de créditos atual da conta e o histórico de uso recente (modelo, endpoint, tokens, custo, status).	read-only

Ferramentas batch

Ferramenta	Descrição	Acesso
upload_batch_file	Envie um arquivo JSONL de solicitações para a API Batch (um objeto {custom_id, method, url, body} por linha). Retorna o id do arquivo para passar para create_batch.	write
get_batch_file_content	Baixe o conteúdo de um arquivo de entrada, saída ou erro de lote como texto JSONL.	read-only
create_batch	Inicie uma execução de lote com desconto a partir de um arquivo JSONL enviado. Cada linha é cobrada no preço do lote quando é executada. Usa créditos.	write
list_batches	Liste as execuções de lote da conta.	read-only
get_batch	Obtenha o status, as contagens e os ids de arquivos de saída de uma execução de lote.	read-only
cancel_batch	Cancele uma execução de lote; linhas que já foram executadas permanecem cobradas.	destructive

Ferramentas gpu

Ferramenta	Descrição	Acesso
list_gpu_types	Lista os tipos de GPU disponíveis para aluguel com preços por hora, VRAM e disponibilidade.	somente leitura
get_gpu_type	Obtém um tipo de GPU pelo slug.	somente leitura
order_gpu_cluster	Encomenda um cluster de GPU multi-nó a partir de um fabric. Cria infraestrutura cobrável cobrada por hora.	gravação
list_gpu_clusters	Lista os fabrics de cluster de GPU multi-nó disponíveis para treinamento distribuído, com contagens de nós e preços.	somente leitura
list_gpu_volumes	Lista os volumes de GPU persistentes da conta.	somente leitura
create_gpu_volume	Cria um volume persistente que pode ser anexado a instâncias de GPU. Armazenamento cobrável.	gravação
get_gpu_volume	Obtém um volume de GPU.	somente leitura
delete_gpu_volume	Exclui um volume de GPU e tudo o que está armazenado nele.	destrutivo
list_gpu_instances	Lista as instâncias de GPU da conta com status, tipo de GPU, preço por hora e detalhes de conexão.	somente leitura
deploy_gpu_instance	Aluga uma GPU e inicia uma carga de trabalho nela (um template, um modelo Hugging Face ou uma imagem de contêiner). Cria uma instância cobrável cobrada por hora até que você a destrua.	gravação
get_gpu_instance	Obtém o status, os endpoints e o custo até o momento de uma instância de GPU.	somente leitura
destroy_gpu_instance	Destrói uma instância de GPU e interrompe seus encargos por hora. Os dados no disco da instância são perdidos, a menos que estejam em um volume anexado.	destrutivo
add_gpu_ssh_key	Autoriza uma chave pública SSH em uma instância de GPU em execução e retorna os detalhes de conexão SSH.	gravação
gpu_instance_action	Para (pausa os encargos de computação por hora), inicia ou atualiza uma instância de GPU.	destrutivo
gpu_workload_send	Envia uma solicitação POST, PUT, PATCH ou DELETE com um corpo JSON para a carga de trabalho em execução na sua instância de GPU por meio do endpoint de conexão autenticado (https://docs.empiriolabs.ai/gpu-cloud). Por exemplo, chame um servidor LLM que você implantou.	gravação
gpu_workload_get	Envia uma solicitação GET para a carga de trabalho em execução na sua instância de GPU por meio do endpoint de conexão autenticado (https://docs.empiriolabs.ai/gpu-cloud). Útil para verificações de integridade e leitura de resultados.	somente leitura

Ferramentas hosted_agents

Ferramenta	Descrição	Acesso
get_hosted_agents_health	Verifica se o serviço de agentes hospedados está disponível.	somente leitura
get_hosted_agent_plans	Obtém os planos de agente hospedado, predefinições de runtime e padrões disponíveis para a conta.	somente leitura
list_hosted_agents	Lista os agentes hospedados da conta com status, tipo de runtime, plano e modelo.	somente leitura
create_hosted_agent	Cria um agente hospedado privado (runtime OpenClaw ou Hermes) em um plano. Cria um recurso cobrável.	gravação
get_hosted_agent	Obtém o status, a configuração e os detalhes de conexão de um agente hospedado.	somente leitura
delete_hosted_agent	Destrói um agente hospedado, seu armazenamento e seus canais, e interrompe seus encargos.	destrutivo
rename_hosted_agent	Altera o nome de exibição de um agente hospedado.	gravação
hosted_agent_action	Inicia, para, reinicia ou atualiza o runtime de um agente hospedado.	destrutivo
message_hosted_agent	Envia mensagens de chat para um agente hospedado em execução e retorna sua resposta. O agente pode usar suas ferramentas conectadas. Usa créditos.	gravação
list_hosted_agent_integrations	Lista os canais de mensagens e integrações conectados a um agente hospedado.	somente leitura
save_hosted_agent_integration	Conecta ou atualiza um canal de mensagens ou integração (por exemplo, telegram, discord, slack) em um agente hospedado.	gravação
disconnect_hosted_agent_integration	Desconecta um canal de mensagens ou integração de um agente hospedado.	destrutivo
set_hosted_agent_channel_behavior	Define como um agente hospedado se comporta em um canal de mensagens (por exemplo, regras de resposta).	gravação
set_hosted_agent_model	Alterna o modelo ou provedor que um agente hospedado usa.	gravação
set_hosted_agent_access	Define o modo de acesso e a lista de permissões para quem pode enviar mensagens a um agente hospedado em seus canais.	gravação
list_hosted_agent_skills	Lista as habilidades instaladas em um agente hospedado.	somente leitura
add_hosted_agent_skill	Instala uma habilidade de catálogo (por slug) ou uma habilidade personalizada em um agente hospedado.	gravação
remove_hosted_agent_skill	Desinstala uma habilidade de um agente hospedado.	destrutivo
list_hosted_agent_mcp_connectors	Lista os conectores MCP remotos anexados a um agente hospedado.	somente leitura
add_hosted_agent_mcp_connector	Anexa um servidor MCP remoto a um agente hospedado para que o agente possa usar suas ferramentas.	gravação
remove_hosted_agent_mcp_connector	Desanexa um conector MCP remoto de um agente hospedado.	destrutivo
get_hosted_agent_stats	Obtém contagens de atividade para um agente hospedado.	somente leitura
list_hosted_agent_poe_models	Lista os modelos disponíveis por meio da conta Poe conectada a um agente hospedado.	somente leitura