Epinu

Epinu MCP — 真实世界资产市场的 Agent 入口

Epinu 是一个面向 Agent 的真实世界资产市场——首先聚焦农业和能源，随后扩展至采矿、设备和工业服务。AI Agent 是一等用户：它们可以直接通过 MCP 搜索、读取和起草交易，且每次写入都会经过人工审批中介，并留下完整审计记录。

这是 Epinu 托管 MCP 端点的公开集成仓库：注册表元数据（官方 MCP Registry 中的 ai.epinu/epinu）、可运行示例和运行检查。Epinu 平台的实现由独立团队维护。

• 端点： https://api.epinu.ai/api/agent/mcp（Streamable HTTP，JSON-RPC 2.0）
• Agent 实时文档： epinu.ai/llms.txt
• 清单： epinu.ai/.well-known/mcp

60 秒快速体验——无需账户或令牌

bash examples/quickstart.sh

这会匿名查询实时公开生产端点，并返回当前公开的项目和市场结果。示例查询目前会显示德克萨斯州敖德萨的一家 ASIC 维修中心及相关服务；库存可能会有变化。（截至 2026-07-15，公开读取不包含 QA 测试数据。）匿名层允许调用 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"
    }
  }
}

连接后即可立即以只读模式使用。若要让 Agent 起草交易，请添加 "headers": {"Authorization": "Bearer epagt_..."}，并使用委派令牌——下文将介绍如何获取。详情请见 examples/claude-code.md。

有意思之处：写入永远不会直接执行

Epinu 的写入工具（marketplace_listing_create、project_create 等）不会写入数据库，而是创建提案（status: pending）并返回 approval_url。人工会在 Epinu 控制面板中审核提案并批准或拒绝——只有获批后才会执行更改。

examples/walkthrough.mjs 展示了由 Agent 控制的流程部分：搜索 → 创建待审批提案 → 检查提案状态。人工审批会在 Epinu 控制面板中另行完成。examples/walkthrough.md 是一次真实生产运行的记录和脱敏文本——提案已创建、经人工审核并被拒绝，整个过程中从未写入任何内容。

为什么每次写入都需要人工批准？

• Agent 会出错，市场是现实存在的。 虚构的商品信息、错误的价格或重复商品，在提案阶段驳回代价很低；上线后再撤销则代价高昂。中介流程让故障模式变成“人工点击了驳回”，而不是“糟糕的写入进入了生产环境”。
• 身份与审计。 每项提案都会记录 actor.type=personal_agent 和 Agent 的客户端 ID。人工始终知道哪个 Agent 提出了什么，并且审计记录会一直保留。
• 限定范围的委托，而非接管账户。 账户所有者会创建 epagt_ 令牌，并明确设置权限范围（Dashboard → Settings → Authorize Agent）。超出权限范围的调用会返回清晰的权限范围错误。敏感操作（删除、修改个人资料）还要求人工在批准时重新完成 MFA 验证。
• 变更检查。 如果底层数据在提案和批准之间发生了实质性变化，系统会阻止批准，或要求明确确认——Agent 无法让过时的变更获得批准。
• 未获批准的提案会在 7 天后自动过期。

生产实践： Epinu 表示，其首位外部市场参与者是通过委托 AI Agent 入驻的：Agent 准备商品目录提案，账户所有者则在 Dashboard 中审核并批准。经过脱敏的案例研究即将发布。

获取令牌（用于写入）

1. 在 epinu.ai/signup 创建账户
2. 前往 Dashboard → Settings → Authorize Agent → 选择权限范围 → 复制 epagt_ 令牌，或让 Agent 的人工操作者访问 https://epinu.ai/authorize-agent?name=<AgentName>&scopes=<scopes>
3. 在 POST /api/agent/mcp 请求中使用 Authorization: Bearer epagt_... （该令牌仅在 MCP 端点上有效）

此仓库包含什么

文件	内容
server.json	ai.epinu/epinu 的 MCP Registry 条目
examples/quickstart.sh	60 秒体验匿名层（curl）
examples/walkthrough.mjs	搜索 → 创建待处理提案 → 查看提案状态（Node，无依赖）
examples/walkthrough.md	真实生产运行的记录稿，已脱敏
examples/claude-code.md	从 Claude Code / .mcp.json 连接
TOOLS.md	匿名层工具参考，附带已捕获的响应
SECURITY.md	如何报告安全漏洞

权威且持续更新的 Agent 文档位于网站本身： llms.txt · .well-known/mcp。此仓库有意采用链接而非镜像的方式，因此内容不会过时。

许可证

此仓库中的示例和文档：MIT。 Epinu 平台本身是托管服务——epinu.ai。