EmpirioLabs AI

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

Para obtener Markdown limpio de cualquier página, añade .md al final de la URL de la página. Para un índice completo de documentación, consulta https://docs.empiriolabs.ai/llms.txt. Para la integración con clientes de IA (Claude Code, Cursor, etc.), conéctate al servidor MCP en https://docs.empiriolabs.ai/_mcp/server.

Servidor MCP

El servidor MCP de EmpirioLabs permite que cualquier cliente del Model Context Protocol ejecute toda la plataforma como herramientas: chatea con todos los modelos de texto, genera imágenes, video, audio, voz, 3D y transcripciones, ejecuta búsqueda web e investigación, gestiona trabajos, lotes, GPU Cloud y agentes alojados, y consulta tu uso y saldo. Es un servidor remoto, por lo que no hay nada que instalar.

URL del servidor

https://mcp.empiriolabs.ai/mcp (HTTP Streamable). Perfiles como /mcp/inference exponen un subconjunto de herramientas.

Inicia sesión o usa una clave

Claude y ChatGPT te permiten iniciar sesión con OAuth. Las herramientas de codificación y los scripts pueden enviar una clave de API de EmpirioLabs como token de portador en su lugar.

Siempre actualizado

Cada modelo y función que EmpirioLabs añade está disponible aquí en cuanto se lanza, con los mismos precios finales y límites que la API.

Tus créditos, tus controles

Las conexiones usan tus créditos. Consulta y desconecta cualquier aplicación conectada en Configuración del panel de control.

Conectar

Claude (web, escritorio, móvil)

1. Abre Configuración, luego Conectores, y elige Añadir conector personalizado.
2. Introduce https://mcp.empiriolabs.ai/mcp como URL. Deja los campos de cliente OAuth vacíos.
3. Haz clic en Conectar, inicia sesión en EmpirioLabs, revisa la solicitud y elige Permitir acceso.

Claude Code usa el mismo servidor:

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

Ejecuta /mcp dentro de Claude Code para completar el inicio de sesión la primera vez.

ChatGPT

1. Abre Configuración, luego Conectores (o Apps), y activa Modo desarrollador en Avanzado.
2. Elige Crear e introduce https://mcp.empiriolabs.ai/mcp como URL del servidor MCP con autenticación OAuth.
3. Completa el inicio de sesión y elige Permitir acceso. El servidor también proporciona las herramientas search y fetch que ChatGPT usa para conectores, por lo que funciona en el chat y en investigación profunda.

Cursor, VS Code, Windsurf y otros editores

Los servidores remotos se configuran con una URL. Inicia sesión mediante OAuth cuando el editor lo solicite, o añade un encabezado de clave de API:

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

VS Code lee la misma estructura desde .vscode/mcp.json con una clave servers y "type": "http". Codex CLI: codex mcp add empiriolabs --url https://mcp.empiriolabs.ai/mcp. Gemini CLI y Windsurf aceptan el bloque JSON anterior en sus ajustes de MCP.

Cualquier cliente HTTP

El servidor habla JSON-RPC sobre POST https://mcp.empiriolabs.ai/mcp y responde con JSON. Envía Authorization: Bearer <API key or OAuth access token> y Accept: application/json, text/event-stream en cada solicitud.

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}}}'

Cómo funciona el acceso

• Inicio de sesión OAuth. Claude, ChatGPT y otros clientes OAuth abren un inicio de sesión de EmpirioLabs. Apruebas la solicitud en el panel de control y la aplicación queda conectada; recibe tokens de corta duración y los renueva por sí sola. Los clientes que lo necesiten pueden descubrir el inicio de sesión a través de los metadatos estándar del recurso en https://mcp.empiriolabs.ai/.well-known/oauth-protected-resource.
• Clave de API. Envía cualquier clave de API activa de EmpirioLabs como token de portador para obtener todas las herramientas sin paso de inicio de sesión. Esto es adecuado para editores, scripts y servidores que controlas.
• Desconexión. Abre Configuración en el panel de control y desconecta la aplicación en Aplicaciones conectadas; pierde el acceso inmediatamente y te pedirá iniciar sesión de nuevo la próxima vez que la uses. Las aplicaciones también pueden desconectarse por sí mismas mediante el endpoint de revocación estándar.
• Ámbitos. Cada conjunto de herramientas a continuación es también un ámbito OAuth, por lo que una aplicación puede solicitar solo lo que necesita y la pantalla de consentimiento muestra exactamente lo que estás concediendo.

Perfiles

Cada conjunto de herramientas está disponible en https://mcp.empiriolabs.ai/mcp. Añade un perfil o una lista de conjuntos de herramientas separada por + a la ruta para exponer una lista de herramientas más pequeña y enfocada, por ejemplo cuando un cliente funciona mejor con menos herramientas o cuando quieres una conexión que no pueda generar medios.

Trabajos y generación de larga duración

Las herramientas de imagen, video, audio, transcripción, 3D, Compose y agentes devuelven URLs de salida finalizadas cuando el trabajo se completa dentro de la ventana de espera (40 segundos por defecto, como máximo 50). De lo contrario, devuelven un job_id y el cliente debe llamar a get_job, que también puede esperar, en lugar de iniciar la generación de nuevo. Las URLs de salida están firmadas y caducan, así que descarga cualquier cosa que quieras conservar. Las herramientas de chat, búsqueda e investigación responden en línea.

Ejemplos de indicaciones

• "Enumera los modelos de video más baratos en EmpirioLabs, luego genera un clip de 5 segundos de olas al atardecer con el de mejor valor."
• "Usa EmpirioLabs para transcribir esta grabación, luego resume los elementos de acción con qwen3-7-max."
• "Consulta mi saldo de EmpirioLabs y muestra cuánto gasté en generación de imágenes esta semana."
• "Despliega un H100 en EmpirioLabs GPU Cloud con la plantilla vLLM y dime cuándo está listo."
• "Ejecuta una tarea de investigación web sobre los últimos cambios de la especificación MCP y cita fuentes."

Precios, límites y errores

Las herramientas usan los mismos precios finales que Modelos y Precios, los mismos límites de cuenta que Límites y Claves de API y los mismos mensajes de error que Errores y Códigos de Estado. Un resultado de herramienta con isError lleva el mismo mensaje accionable que devuelve la API, por ejemplo cuando un modelo no admite el endpoint solicitado o cuando la cuenta necesita créditos.

Privacidad

Las indicaciones y salidas no se almacenan para inspección. Los registros de uso conservan solo metadatos como modelo, tokens, costo y estado. Consulta la Política de Privacidad y Soporte.

Referencia de herramientas

Las herramientas se agrupan por conjunto de herramientas. Un conjunto de herramientas es también el ámbito que una aplicación solicita al conectarse, por lo que la pantalla de consentimiento y esta referencia usan los mismos nombres.

Conjuntos de herramientas y ámbitos

Conjunto de herramientas (ámbito OAuth)	Qué permite	Herramientas
models	Explorar el catálogo de modelos, precios, capacidades y parámetros	5
text	Ejecutar chat, embeddings, reranking y detección de texto IA (usa créditos)	4
search	Ejecutar búsqueda web, respuestas fundamentadas e investigación (usa créditos)	3
media	Generar y editar imágenes, video, audio, voz, transcripción y 3D (usa créditos)	13
jobs	Consultar, esperar y cancelar trabajos de generación	3
agents	Ejecutar y gestionar tareas de agentes (usa créditos)	4
account	Leer el historial de uso y el saldo actual	1
batch	Subir archivos de lote y gestionar trabajos de lote (usa créditos)	6
gpu	Desplegar y gestionar instancias GPU, clústeres y volúmenes (facturable)	16
hosted_agents	Crear y gestionar agentes alojados (facturable)	23

Perfiles

URL	Conjuntos de herramientas
https://mcp.empiriolabs.ai/mcp	todos los conjuntos de herramientas
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

Combina conjuntos de herramientas o perfiles con +, por ejemplo https://mcp.empiriolabs.ai/mcp/models+text+jobs.

Herramientas de models

Herramienta	Descripción	Acceso
list_models	Lista los modelos de EmpirioLabs con proveedor, modalidad, endpoints y precios finales. Filtra por consulta de texto libre, modalidad (texto, imagen, video, audio, multimodal, 3D), categoría, proveedor o ruta de endpoint. Llama a esto antes de elegir un id de modelo.	solo lectura
get_model	Obtén el esquema completo de un modelo: descripción, endpoints, ventana de contexto, precios finales, notas y cada parámetro admitido con valores predeterminados y rangos.	solo lectura
search	Busca en el catálogo de modelos y la documentación de EmpirioLabs. Devuelve ids de resultado para fetch: model: para un modelo, doc: para una página de documentación.	solo lectura
fetch	Obtén el texto completo de un resultado de búsqueda por id (model: o doc:).	solo lectura
get_platform_status	Comprueba si la API de EmpirioLabs y sus modelos están actualmente activos, con disponibilidad por modelo.	solo lectura

Herramientas de text

Herramienta	Descripción	Acceso
chat	Ejecuta una finalización de chat en cualquier modelo de chat de EmpirioLabs y devuelve la respuesta del asistente, razonamiento (cuando el modelo lo expone), llamadas a herramientas y uso de tokens. Usa créditos.	escritura
embeddings	Crea vectores de embedding para uno o más textos con un modelo de embedding. Usa créditos.	escritura
rerank	Puntúa y reordena documentos por relevancia a una consulta con un modelo de reranking. Usa créditos.	escritura
detect_ai_text	Clasifica si un texto fue escrito por un modelo de IA (GPTZero). Usa créditos.	escritura

Herramientas de search

Herramienta	Descripción	Acceso
web_search	Ejecuta una búsqueda web en vivo a través de un modelo de búsqueda (por ejemplo, exa-search, tavily-search, linkup-search). Devuelve resultados con títulos, URLs y fragmentos. Usa créditos.	write
web_research	Ejecuta una tarea de investigación de varios pasos con citas (por ejemplo, tavily-research, exa-research, linkup-deep-search). Tarda hasta unos minutos. Usa créditos.	write
web_answer	Obtén una respuesta de una sola vez con citas de un modelo de respuesta fundamentada (por ejemplo, exa-answer). Usa créditos.	write

Herramientas de media

Herramienta	Descripción	Acceso
generate_image	Genera imágenes a partir de un prompt (o una plantilla de generación) con un modelo de imágenes. Devuelve URLs de salida firmadas, o un job_id para consultar con get_job cuando la generación tarda más que la espera. Usa créditos.	write
generate_video	Genera un video a partir de un prompt, una imagen o una plantilla de efecto creativo con un modelo de video. El video tarda minutos: la herramienta devuelve un job_id y debes consultar get_job hasta que la URL de salida firmada esté lista. Usa créditos.	write
list_generation_templates	Lista plantillas de generación de imágenes y videos curadas (efectos creativos) con su slug, modalidad, modelo recomendado y entradas.	read-only
get_generation_template	Obtén una plantilla de generación por slug, incluyendo su guía de prompt, modelo recomendado y parámetros predeterminados.	read-only
list_compose_recipes	Lista las recetas de Compose que encadenan guion, visuales, voz y música en un video terminado, con sus modos y entradas.	read-only
compose_video	Crea un video terminado a partir de una receta de Compose (brief, guion, storyboard o ediciones). Devuelve un job_id para consultar con get_job. Usa créditos.	write
generate_3d	Genera un modelo 3D a partir de una imagen con un modelo de generación 3D (por ejemplo, trellis-2-4b). Devuelve un job_id para consultar con get_job. Usa créditos.	write
text_to_speech	Sintetiza voz a partir de texto con un modelo TTS y una voz. Devuelve una URL de audio firmada (o audio en línea). Usa créditos.	write
list_voices	Lista las voces disponibles para texto a voz, filtrables por modelo, idioma, género o texto de búsqueda.	read-only
generate_audio	Genera música o efectos de sonido a partir de un prompt con un modelo de generación de audio (por ejemplo, ace-step-1-5-xl). Devuelve una URL firmada o un job_id para get_job. Usa créditos.	write
transcribe_audio	Transcribe un archivo de audio o video en una URL https con un modelo de voz a texto. Devuelve la transcripción o un job_id para get_job. Usa créditos.	write
analyze_image	Haz una pregunta sobre una imagen con un modelo con capacidad de visión y obtén una respuesta de texto. Usa créditos.	write
edit_image	Edita una imagen existente con una instrucción usando un modelo de edición de imágenes. Devuelve URLs de salida firmadas o un job_id para get_job. Usa créditos.	write

Herramientas de jobs

Herramienta	Descripción	Acceso
list_jobs	Lista los trabajos asíncronos recientes de la cuenta, los más nuevos primero.	read-only
get_job	Obtén el estado y el resultado de un trabajo de generación asíncrono. Opcionalmente, espera hasta wait_seconds para que termine. Nunca reinicies un trabajo que aún esté procesando.	read-only
cancel_job	Cancela un trabajo en cola o en procesamiento. Los trabajos completados se devuelven sin cambios.	destructive

Herramientas de agents

Herramienta	Descripción	Acceso
run_agent_task	Inicia una tarea de agente de larga duración (por ejemplo, con el modelo manus) o envía un mensaje de seguimiento a una tarea existente. Devuelve un job_id para get_job y el task_id para get_agent_task. Usa créditos.	write
get_agent_task	Obtén el estado y la salida de una tarea de agente.	read-only
get_agent_task_messages	Lista los mensajes intercambiados durante una tarea de agente.	read-only
stop_agent_task	Detén una tarea de agente en ejecución.	destructive

Herramientas de account

Herramienta	Descripción	Acceso
get_account_usage	Lee el saldo de créditos actual de la cuenta y el historial de uso reciente (modelo, endpoint, tokens, costo, estado).	read-only

Herramientas de batch

Herramienta	Descripción	Acceso
upload_batch_file	Sube un archivo JSONL de solicitudes para la API Batch (un objeto {custom_id, method, url, body} por línea). Devuelve el id del archivo para pasar a create_batch.	write
get_batch_file_content	Descarga el contenido de un archivo de entrada, salida o error de batch como texto JSONL.	read-only
create_batch	Inicia una ejecución de batch con descuento desde un archivo JSONL subido. Cada línea se factura al precio de batch cuando se ejecuta. Usa créditos.	write
list_batches	Lista las ejecuciones de batch de la cuenta.	read-only
get_batch	Obtén el estado, los conteos y los ids de archivos de salida de una ejecución de batch.	read-only
cancel_batch	Cancela una ejecución de batch; las líneas que ya se ejecutaron siguen facturadas.	destructive

Herramientas de gpu

Herramienta	Descripción	Acceso
list_gpu_types	Lista los tipos de GPU disponibles para alquilar con precios por hora, VRAM y disponibilidad.	solo lectura
get_gpu_type	Obtén un tipo de GPU por slug.	solo lectura
order_gpu_cluster	Ordena un clúster de GPU multinodo desde un tejido. Crea infraestructura facturable cobrada por hora.	escritura
list_gpu_clusters	Lista los tejidos de clústeres de GPU multinodo disponibles para entrenamiento distribuido, con recuentos de nodos y precios.	solo lectura
list_gpu_volumes	Lista los volúmenes de GPU persistentes de la cuenta.	solo lectura
create_gpu_volume	Crea un volumen persistente que se puede adjuntar a instancias de GPU. Almacenamiento facturable.	escritura
get_gpu_volume	Obtén un volumen de GPU.	solo lectura
delete_gpu_volume	Elimina un volumen de GPU y todo lo almacenado en él.	destructivo
list_gpu_instances	Lista las instancias de GPU de la cuenta con estado, tipo de GPU, precio por hora y detalles de conexión.	solo lectura
deploy_gpu_instance	Alquila una GPU y ejecuta una carga de trabajo en ella (una plantilla, un modelo de Hugging Face o una imagen de contenedor). Crea una instancia facturable cobrada por hora hasta que la destruyas.	escritura
get_gpu_instance	Obtén el estado, los endpoints y el costo hasta ahora de una instancia de GPU.	solo lectura
destroy_gpu_instance	Destruye una instancia de GPU y detén sus cargos por hora. Los datos en el disco de la instancia se pierden a menos que estén en un volumen adjunto.	destructivo
add_gpu_ssh_key	Autoriza una clave pública SSH en una instancia de GPU en ejecución y devuelve los detalles de conexión SSH.	escritura
gpu_instance_action	Detén (pausa los cargos de cómputo por hora), inicia o actualiza una instancia de GPU.	destructivo
gpu_workload_send	Envía una solicitud POST, PUT, PATCH o DELETE con un cuerpo JSON a la carga de trabajo que se ejecuta en tu instancia de GPU a través del endpoint de conexión autenticado (https://docs.empiriolabs.ai/gpu-cloud). Por ejemplo, llama a un servidor LLM que hayas implementado.	escritura
gpu_workload_get	Envía una solicitud GET a la carga de trabajo que se ejecuta en tu instancia de GPU a través del endpoint de conexión autenticado (https://docs.empiriolabs.ai/gpu-cloud). Útil para comprobaciones de salud y lectura de resultados.	solo lectura

Herramientas de hosted_agents

Herramienta	Descripción	Acceso
get_hosted_agents_health	Comprueba si el servicio de agentes alojados está disponible.	solo lectura
get_hosted_agent_plans	Obtén los planes de agente alojado, los ajustes preestablecidos de tiempo de ejecución y los valores predeterminados disponibles para la cuenta.	solo lectura
list_hosted_agents	Lista los agentes alojados de la cuenta con estado, tipo de tiempo de ejecución, plan y modelo.	solo lectura
create_hosted_agent	Crea un agente alojado privado (tiempo de ejecución OpenClaw o Hermes) en un plan. Crea un recurso facturable.	escritura
get_hosted_agent	Obtén el estado, la configuración y los detalles de conexión de un agente alojado.	solo lectura
delete_hosted_agent	Destruye un agente alojado, su almacenamiento y sus canales, y detén sus cargos.	destructivo
rename_hosted_agent	Cambia el nombre para mostrar de un agente alojado.	escritura
hosted_agent_action	Inicia, detiene, reinicia o actualiza el tiempo de ejecución de un agente alojado.	destructivo
message_hosted_agent	Envía mensajes de chat a un agente alojado en ejecución y devuelve su respuesta. El agente puede usar sus herramientas conectadas. Usa créditos.	escritura
list_hosted_agent_integrations	Lista los canales de mensajería e integraciones conectados a un agente alojado.	solo lectura
save_hosted_agent_integration	Conecta o actualiza un canal de mensajería o integración (por ejemplo, telegram, discord, slack) en un agente alojado.	escritura
disconnect_hosted_agent_integration	Desconecta un canal de mensajería o integración de un agente alojado.	destructivo
set_hosted_agent_channel_behavior	Establece cómo se comporta un agente alojado en un canal de mensajería (por ejemplo, reglas de respuesta).	escritura
set_hosted_agent_model	Cambia el modelo o proveedor que usa un agente alojado.	escritura
set_hosted_agent_access	Establece el modo de acceso y la lista de permitidos para quién puede enviar mensajes a un agente alojado en sus canales.	escritura
list_hosted_agent_skills	Lista las habilidades instaladas en un agente alojado.	solo lectura
add_hosted_agent_skill	Instala una habilidad de catálogo (por slug) o una habilidad personalizada en un agente alojado.	escritura
remove_hosted_agent_skill	Desinstala una habilidad de un agente alojado.	destructivo
list_hosted_agent_mcp_connectors	Lista los conectores MCP remotos adjuntos a un agente alojado.	solo lectura
add_hosted_agent_mcp_connector	Adjunta un servidor MCP remoto a un agente alojado para que el agente pueda usar sus herramientas.	escritura
remove_hosted_agent_mcp_connector	Desconecta un conector MCP remoto de un agente alojado.	destructivo
get_hosted_agent_stats	Obtén recuentos de actividad para un agente alojado.	solo lectura
list_hosted_agent_poe_models	Lista los modelos disponibles a través de la cuenta de Poe conectada a un agente alojado.	solo lectura