Epinu

Epinu MCP — puerta de agente para un mercado de activos del mundo real

Epinu es un mercado de activos del mundo real que prioriza a los agentes — agro y energía primero, ampliándose a minería, equipos y servicios industriales. Los agentes de IA son usuarios de primera clase: pueden buscar, leer y redactar acuerdos directamente a través de MCP, y cada escritura pasa por un intermediario de aprobación humana con un registro de auditoría completo.

Este es el repositorio de integración pública para el endpoint MCP alojado de Epinu: metadatos de registro (ai.epinu/epinu en el Registro MCP oficial), ejemplos ejecutables y comprobaciones operativas. La implementación de la plataforma Epinu se mantiene por separado.

• Endpoint: https://api.epinu.ai/api/agent/mcp (Streamable HTTP, JSON-RPC 2.0)
• Documentación en vivo para agentes: epinu.ai/llms.txt
• Manifiesto: epinu.ai/.well-known/mcp

Pruébalo en 60 segundos — sin cuenta, sin token

bash examples/quickstart.sh

Eso consulta el endpoint público de producción en vivo de forma anónima y devuelve los resultados públicos actuales de proyectos y del mercado. Las consultas de ejemplo muestran actualmente un centro de reparación de ASIC en Odessa, TX y servicios relacionados; el inventario puede cambiar. (Los datos de prueba de QA están excluidos de las lecturas públicas a partir de 2026-07-15.) El nivel anónimo permite initialize, tools/list, y cinco herramientas de lectura (getting_started, marketplace_listings_search, projects_search, search y fetch) contra datos públicos — consulta TOOLS.md para la referencia.

O el mismo flujo en Node plano (cero dependencias, Node ≥ 18):

node examples/walkthrough.mjs

Conéctate desde Claude Code / cualquier cliente MCP

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

o en .mcp.json:

{
  "mcpServers": {
    "epinu": {
      "type": "http",
      "url": "https://api.epinu.ai/api/agent/mcp"
    }
  }
}

Funciona de inmediato en modo de solo lectura. Para permitir que tu agente redacte acuerdos, agrega "headers": {"Authorization": "Bearer epagt_..."} con un token delegado — mira abajo cómo obtener uno. Detalles en examples/claude-code.md.

La parte interesante: las escrituras nunca se ejecutan

Las herramientas de escritura de Epinu (marketplace_listing_create, project_create, …) no escriben en la base de datos. Crean propuestas (status: pending) y devuelven un approval_url. Un humano revisa la propuesta en el panel de Epinu y la aprueba o la rechaza — solo la aprobación ejecuta el cambio.

examples/walkthrough.mjs demuestra la parte controlada por el agente del flujo: buscar → crear una propuesta pendiente → verificar su estado. La aprobación humana ocurre por separado en el panel de Epinu. examples/walkthrough.md es la transcripción grabada y redactada de una ejecución real de producción — propuesta creada, revisada y rechazada por el humano, sin que nada se haya escrito jamás.

¿Por qué cada escritura es aprobada por un humano?

• Los agentes cometen errores; los mercados son reales. Una publicación alucinada, un precio incorrecto o un duplicado es barato de rechazar en el momento de la propuesta y caro de deshacer una vez que está en vivo. El intermediario convierte el modo de fallo en "un humano hizo clic en rechazar", no en "una escritura incorrecta llegó a producción".
• Identidad y auditoría. Cada propuesta registra actor.type=personal_agent y el ID de cliente del agente. El humano siempre sabe qué agente propuso qué, y el rastro sobrevive.
• Delegación con alcance, no apropiación de cuenta. Un token epagt_ es creado por el propietario de la cuenta con alcances explícitos (Panel → Configuración → Autorizar Agente). Las llamadas fuera de alcance fallan con un error de alcance limpio. Las acciones sensibles (eliminaciones, cambios de perfil) además requieren MFA reciente del lado humano en el momento de la aprobación.
• Comprobaciones de desvío. Si los datos subyacentes cambiaron materialmente entre la propuesta y la aprobación, la aprobación se bloquea o requiere reconocimiento explícito — un agente no puede lograr que se apruebe un cambio obsoleto.
• Las propuestas no aprobadas caducan por sí solas (7 días).

Experiencia de producción: Epinu informa que su primer participante externo del mercado se incorporó a través de un agente de IA delegado: el agente preparó las propuestas de catálogo, y el propietario de la cuenta las revisó y aprobó en el panel. Un estudio de caso anonimizado está por publicarse.

Obtener un token (para escrituras)

1. Crea una cuenta en epinu.ai/signup
2. Panel → Configuración → Autorizar Agente → elige los alcances → copia el token epagt_, o envía al humano de tu agente a https://epinu.ai/authorize-agent?name=<AgentName>&scopes=<scopes>
3. Úsalo como Authorization: Bearer epagt_... en POST /api/agent/mcp (el token es válido solo en el endpoint MCP)

Qué hay en este repositorio

Archivo	Qué es
server.json	La entrada del Registro MCP para ai.epinu/epinu
examples/quickstart.sh	Nivel anónimo en 60 segundos (curl)
examples/walkthrough.mjs	Buscar → crear propuesta pendiente → verificar estado de la propuesta (Node, cero dependencias)
examples/walkthrough.md	Transcripción grabada y redactada de una ejecución real de producción
examples/claude-code.md	Conéctate desde Claude Code / .mcp.json
TOOLS.md	Referencia de herramientas del nivel anónimo con respuestas capturadas
SECURITY.md	Cómo reportar una vulnerabilidad

La documentación canónica y siempre actualizada para agentes vive en el propio sitio: llms.txt · .well-known/mcp. Este repositorio deliberadamente enlaza en lugar de reflejar, para que no pueda quedar obsoleto.

Licencia

Ejemplos y documentación en este repositorio: MIT. La plataforma Epinu en sí es un servicio alojado — epinu.ai.