Epinu MCP — агент-посредник для реального промышленного рынка

Epinu — это рынок, ориентированный на агентов, для реальных промышленных активов — услуги по ремонту ASIC, оборудование для майнинга и энергетики, а также посредничество в сделках со скотоводством. AI-агенты — пользователи первого класса: они могут искать, читать и составлять сделки напрямую через MCP, и каждая запись проходит через брокера с человеческим одобрением и полной аудиторской трассой.

Это публичное интеграционное репозиторий для размещённого Epinu MCP-эндпойнта: регистрационные данные (registry metadata) (ai.epinu/epinu в официальном MCP Registry), воспроизводимые примеры и операционные проверки.

Реализация платформы Epinu поддерживается отдельно.

Эндпойнт: https://api.epinu.ai/api/agent/mcp (Streamable HTTP, JSON-RPC 2.0)
Документация для агентов в реальном времени: epinu.ai/llms.txt
Манифест: epinu.ai/.well-known/mcp

Попробуйте за 60 секунд — без учётной записи, без токена

bash examples/quickstart.sh

Это запрос к живому публичному продакшн-эндпойнту анонимно и возвращает текущие результаты публичного проекта и маркетплейса. Примеры запросов сейчас показывают центр ремонта ASIC в Odessa, TX и связанные сервисы; наличие может меняться. (На 2026-07-15 тестовые данные не доступны в публичном доступе). Анонимный уровень позволяет

initialize, tools/list и пять инструментов для чтения (getting_started, marketplace_listings_search, projects_search, search и fetch) — на публичные данные — см. TOOLS.md для справки.

И тот же процесс на чистом Node (ноль зависимостей, Node ≥ 18):

node examples/walkthrough.mjs

Подключение через Claude Code / любых MCP-клиентов

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

или в .mcp.json:

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

Работает сразу в режиме только для чтения. Чтобы ваш агент мог черновать сделки, добавьте

"headers": {"Authorization": "Bearer epagt_..."} с делегированным токеном — см. ниже, как получить его. Подробности в examples/claude-code.md.

Интересная часть: записи никогда не выполняются

Инструменты записи Epinu (marketplace_listing_create, project_create, …) не записывают данные в базу данных. Они создают предложения (status: pending) и возвращают approval_url. Человек просматривает предложение в панели Epinu и либо одобряет, либо отклоняет — только одобрение выполняет изменение.

examples/walkthrough.mjs демонстрирует контролируемую агентом часть процесса: поиск → создание чернового предложения → проверка статуса. Одобрение человеком происходит отдельно в панели Epinu.

examples/walkthrough.md — записанная, обезличенная транскрипция реального продакшн-цикла — предложение создано, рассмотрено и отклонено человеком, и ничего не записано.

Почему каждое письмо требует одобрения человека?

Агенты совершают ошибки; рынки реальны. Сгенерированное listing-описание, неверная цена или дубликат легко отклонить на этапе предложения и трудно исправлять после запуска. Брокер превращает отказ в понятный режим ошибки: «человек нажал отклонить», а не «мошенническая запись попала в продакшн».
Идентификация и аудит. Каждое предложение фиксирует actor.type=personal_agent и идентификатор клиента агента. Человек всегда знает, какой агент предложил что, и след остаётся.
Ограниченная делегация, а не захват аккаунта. Токен вида epagt_ создаётся владельцем аккаунта с явными диапазонами доступа (Панель → Настройки → Авторизация агента). Вызовы вне зоны доступа возвращают чистую ошибку области. Чувствительные действия (удаление, изменения профиля) дополнительно требуют свежего MFA со стороны человека в момент одобрения.
Проверка дрейфа. Если данные кардинально изменились между предложением и одобрением, одобрение либо блокируется, либо требует явного подтверждения — агент не сможет получить одобрение устаревшего изменения.
Неподтверждённые предложения истекают сами по себе (7 дней).

Производственный опыт: Epinu сообщает, что первый внешний участник маркетплейса был onboarded через делегированного AI-агента: агент подготовил каталожные предложения, владелец аккаунта просмотрел и одобрил их в панели управления. В ближайшее время будет опубликовано санитаризованное кейс-изучение.

Получение токена (для записей)

Создайте аккаунт на epinu.ai/signup
Панель управления → Настройки → Авторизация агента → выберите области доступа → скопируйте токен epagt_, или направьте человека вашего агента на

https://epinu.ai/authorize-agent?name=<AgentName>&scopes=<scopes>

Используйте его как Authorization: Bearer epagt_... на POST /api/agent/mcp (токен действителен только на MCP-эндпойнте)

Что находится в этом репозитории

Файл	Что это такое
server.json	Запись MCP Registry для ai.epinu/epinu
examples/quickstart.sh	Анонимный уровень за 60 секунд (curl)
examples/walkthrough.mjs	Поиск → создание чернового предложения → проверка статуса предложения (Node, ноль зависимостей)
examples/walkthrough.md	Записанный, обезличенный транскрипт реального продакшн-цикла
examples/claude-code.md	Подключение через Claude Code / .mcp.json
TOOLS.md	Справочник инструментов анонимного тарифа с зафиксированными ответами
SECURITY.md	Как сообщать об уязвимости

canonical, всегда актуальная документация агента находится на самом сайте:

llms.txt ·

.well-known/mcp. Этот репозиторий намеренно соединяет ссылки, а не зеркалирует, чтобы не устареть.

Лицензия

Примеры и документация в этом репозитории: MIT.

Сама платформа Epinu — это размещённый сервис — epinu.ai.