Epinu

Epinu MCP — porta de entrada para agentes em um marketplace de ativos do mundo real

Epinu é um marketplace que prioriza agentes para ativos do mundo real — agronegócio e energia primeiro, expandindo para mineração, equipamentos e serviços industriais. Agentes de IA são usuários de primeira classe: eles podem pesquisar, ler e redigir negociações diretamente via MCP, e toda escrita passa por um intermediário de aprovação humana com trilha de auditoria completa.

Este é o repositório público de integração para o endpoint MCP hospedado da Epinu: metadados de registro (ai.epinu/epinu no Registro MCP oficial), exemplos executáveis e verificações operacionais. A implementação da plataforma Epinu é mantida separadamente.

• Endpoint: https://api.epinu.ai/api/agent/mcp (Streamable HTTP, JSON-RPC 2.0)
• Documentação ao vivo para agentes: epinu.ai/llms.txt
• Manifesto: epinu.ai/.well-known/mcp

Experimente em 60 segundos — sem conta, sem token

bash examples/quickstart.sh

Isso consulta o endpoint público de produção de forma anônima e retorna resultados públicos atuais do projeto e do marketplace. As consultas de exemplo atualmente trazem um centro de reparo de ASIC em Odessa, TX e serviços relacionados; o inventário pode mudar. (Fixtures de QA são excluídas das leituras públicas desde 2026-07-15.) O nível anônimo permite initialize, tools/list e cinco ferramentas de leitura (getting_started, marketplace_listings_search, projects_search, search e fetch) contra dados públicos — veja TOOLS.md para a referência.

Ou o mesmo fluxo em Node puro (zero dependências, Node ≥ 18):

node examples/walkthrough.mjs

Conecte-se a partir do Claude Code / qualquer cliente MCP

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

ou em .mcp.json:

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

Funciona imediatamente em modo somente leitura. Para permitir que seu agente redija negociações, adicione "headers": {"Authorization": "Bearer epagt_..."} com um token delegado — veja abaixo como obter um. Detalhes em examples/claude-code.md.

A parte interessante: escritas nunca são executadas

As ferramentas de escrita da Epinu (marketplace_listing_create, project_create, …) não escrevem no banco de dados. Elas criam propostas (status: pending) e retornam um approval_url. Um humano revisa a proposta no painel da Epinu e a aprova ou rejeita — somente a aprovação executa a alteração.

examples/walkthrough.mjs demonstra a porção controlada por agente do fluxo: buscar → criar uma proposta pendente → verificar seu status. A aprovação humana acontece separadamente no painel da Epinu. examples/walkthrough.md é a transcrição gravada e editada de uma execução real de produção — proposta criada, revisada e rejeitada pelo humano, sem que nada fosse escrito.

Por que toda escrita é aprovada por humanos?

• Agentes cometem erros; mercados são reais. Uma listagem alucinada, um preço errado ou uma duplicata é barato rejeitar no momento da proposta e caro de desfazer depois que está no ar. O intermediário torna o modo de falha "um humano clicou em rejeitar", não "uma escrita ruim atingiu a produção".
• Identidade e auditoria. Cada proposta registra actor.type=personal_agent e o client id do agente. O humano sempre sabe qual agente propôs o quê, e a trilha sobrevive.
• Delegação com escopo, não assunção de conta. Um token epagt_ é criado pelo proprietário da conta com escopos explícitos (Painel → Configurações → Autorizar Agente). Chamadas fora do escopo falham com um erro de escopo claro. Ações sensíveis (exclusões, alterações de perfil) exigem adicionalmente MFA recente no lado humano no momento da aprovação.
• Verificações de divergência. Se os dados subjacentes mudaram materialmente entre a proposta e a aprovação, a aprovação é bloqueada ou exige confirmação explícita — um agente não consegue obter aprovação para uma alteração desatualizada.
• Propostas não aprovadas expiram sozinhas (7 dias).

Experiência de produção: a Epinu relata que seu primeiro participante externo do marketplace foi integrado por meio de um agente de IA delegado: o agente preparou as propostas de catálogo, e o proprietário da conta as revisou e aprovou no painel. Um estudo de caso sanitizado está por vir.

Obtendo um token (para escritas)

1. Crie uma conta em epinu.ai/signup
2. Painel → Configurações → Autorizar Agente → escolha os escopos → copie o token epagt_, ou envie o humano do seu agente para https://epinu.ai/authorize-agent?name=<AgentName>&scopes=<scopes>
3. Use-o como Authorization: Bearer epagt_... em POST /api/agent/mcp (o token é válido somente no endpoint MCP)

O que há neste repositório

Arquivo	O que é
server.json	A entrada do Registro MCP para ai.epinu/epinu
examples/quickstart.sh	Nível anônimo em 60 segundos (curl)
examples/walkthrough.mjs	Buscar → criar proposta pendente → verificar status da proposta (Node, zero deps)
examples/walkthrough.md	Transcrição gravada e editada de uma execução real de produção
examples/claude-code.md	Conecte-se a partir do Claude Code / .mcp.json
TOOLS.md	Referência de ferramentas do nível anônimo com respostas capturadas
SECURITY.md	Como reportar uma vulnerabilidade

A documentação canônica e sempre atualizada para agentes vive no próprio site: llms.txt · .well-known/mcp. Este repositório deliberadamente faz link em vez de espelhar, para não ficar desatualizado.

Licença

Exemplos e documentação neste repositório: MIT. A própria plataforma Epinu é um serviço hospedado — epinu.ai.