Tereno on Base

---

⚡ 为何需要它

读取合约、签署交易或抓取网页的 Agent，依赖的是无法核实的信息。大多数工具会回答是什么，却没有工具告诉你答案能保持多久有效。

tereno-mcp 将 Tereno 接入任何 MCP 客户端。每个付费答案都会附带其依据、依据的局限，以及答案失效时对应的区块。

• 无需 API 密钥，无需注册。 Agent 的钱包就是其身份。
• 付款前先了解价格。 tereno_price 会告知费用及答案是否已存在，无需钱包，也不会产生任何承诺。
• 共享更省钱。 确定性答案会在多个 Agent 之间复用：第一个调用者支付计算费用，之后的调用者只需支付复用价格。

🚀 安装

将其添加到任何 MCP 客户端——Claude Desktop、Claude Code、Cursor、Cline、Windsurf：

{
  "mcpServers": {
    "tereno": {
      "command": "npx",
      "args": ["-y", "tereno-mcp"]
    }
  }
}

重启客户端即可。无需其他配置，免费工具会立即生效。

🆓 免费使用，无需钱包

工具	回答的问题
📖 tereno_catalog	Tereno 能回答什么？费用是多少？每个答案有效期多长？
🏷️ tereno_price	这次具体调用现在需要多少钱？答案是否已存在？
🧾 tereno_receipt	已结算的调用实际收取了多少费用：档位、标价、抵扣金额和实付价格？

tereno_price 最值得了解。它会明确告知复用档位：

hit      another agent already paid to compute this and it is still fresh
partial  the durable half survived; only the expired part is recomputed
miss     nothing to reuse — this call computes it, and the next asker pays less

💳 按次付费

工具	价格	它回答的问题
🚦 transaction_intent_guard	$0.005	这笔交易签名安全吗？ 模拟、Gas、余额和授权额度变化、无限授权标记
🛡️ contract_guard	$0.001–3	与这个合约交互安全吗？（代码、代理、暂停状态）
🕵️ contract_change	$0.001–2	自上次查看后有变化吗？（审计后跑路检测器）
🪙 token_metadata	$0.001–3	这到底是什么代币？（名称、符号、精度、供应量）
🧬 contract_interface	$0.001–2	ERC-20？NFT？代理？一次有界探测
⛽ chain_snapshot	$0.001–2	最新的 Base 区块、基础费用和建议 Gas，无需参数
📄 web_compile	$0.001–5	公共 URL → 带有已解析链接、引用和可复用产物的有界 Markdown
🔎 evidence_artifact	$0.001–3	这个公共产物可以复用吗？来源、字段有效性、重新计算所需输入
🤝 demand_pledge	免费	指出一项你愿意付费购买的能力。只有同一钱包之后为它付费，才会记账

调用付费工具会返回一个 402，其中 error.data.paymentRequired 携带付款挑战， error.data.resource 提供可付款的资源 URL，而 error.data.offer 提供条款（网络、资产、金额、payTo）。

通过 stdio 无法重试工具调用来付款。 stdio 的收发两个方向都没有标头，因此无法通过它传回 PAYMENT-SIGNATURE。以下两种方式都不会让此软件包接触私钥：

• 通过 HTTP 为资源付款。 使用你的 x402 客户端为 error.data.paymentRequired 签名，并将已签名的请求发送到 error.data.resource。它会返回与工具调用相同的载荷，包括收据，只计费一次。
• 改用远程服务，而不是此软件包。 如果你的客户端支持远程 MCP，请将其指向 https://www.tereno.xyz/api/mcp。这种传输方式 支持标头，因此签署挑战并重试同一工具调用是常规流程，整个过程都在 MCP 内完成。

🔒 transaction_intent_guard 的结果绝不会缓存、共享或转售。未签名的交易代表意图，会始终留在为其付款的钱包中。

⚙️ 配置

环境变量	默认值	用途
TERENO_WALLET	—	付款前公布的 Base 地址，以便将挑战绑定到将进行结算的钱包。可选。
TERENO_BASE_URL	https://www.tereno.xyz	指向其他 Tereno 部署。
TERENO_TIMEOUT_MS	45000	上游请求超时。
TERENO_EVIDENCE_INSTALLATION_ID	—	此 MCP 安装的可选稳定随机 ID。仅在解析从其他 Agent 收到的证据时进行哈希处理；切勿使用钱包或密钥。

🔐 此软件包的功能与限制

它是托管端点 /api/mcp 前面的 stdio 传输层。消息会原样转发，因此工具列表、价格和付款挑战都来自与 HTTP Agent 所见的同一处——能力发生变化时，无需发布此软件包的新版本。

它唯一转换的是付款，而且这种转换会造成单向信息损失。通过 HTTP，挑战会出现在响应标头中，调用方使用 PAYMENT-SIGNATURE 标头重试。stdio 两者都不支持，因此挑战会被放入 JSON-RPC 错误载荷中，客户端仍可读取；而签名则无法传回。这就是为什么付费调用要通过资源 URL 结算，而不是通过重试工具来结算，也解释了为什么支持远程 MCP 的客户端应优先使用托管端点。

绝不会读取、存储或传输任何私钥。 此软件包没有依赖，整个程序只有一个易读文件——在让它在你的机器上运行之前，先阅读它。

如果你的客户端支持远程 MCP 服务，请跳过此软件包，直接将其指向 https://www.tereno.xyz/api/mcp。

🌱 它如何保持低成本——协作层

Tereno 是一个共享缓存协调层，而不只是一个 API。第一个为某项经过验证的工作付费的 Agent，会将其成果提供给整个网络；之后每个复用该结果的 Agent 支付的费用都会更低，而提供成果的 Agent 会获得少量不可转让的额度，用于抵扣自己未来调用的费用。

安全是一种公共产品，但成本由个人承担。让首次计算能从每次复用中获益，网络就把“我付费检查了这份合约”变成了“我降低了所有人检查它的价格，而且我自己的检查也更便宜了。”

坦诚地说明一下：奖励是不可转让的额度，且每项成果都有上限。这些额度用于补充 Agent 的预算，并非收益。

发现、评分、声誉、定价和全局缓存都位于 Tereno 的闭源后端中。此服务及其 SDK （tereno-client）是面向该后端的公开开放接口。

🤝 支持与社区

• 💬 问题 / 配置 → Tereno Discord
• 🐛 Bug → 问题反馈 · ⚠️ 切勿粘贴私钥或 .env
• 🔒 漏洞 → 私下报告

🔗 链接

在线目录 · OpenAPI · MCP 注册表条目 · 面向 ElizaOS 的 plugin-tereno · tereno-client SDK

---