Tereno on Base

xyz.tereno由 tereno.xyz 發布官方發布者v0.1.3更新於 Oct 24, 2026

Check a Base contract, transaction or web page before you act. Free pricing, paid per call in USDC.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取金融安全與監控

概覽

AI 產生的概覽

Tereno on Base 讓助理免費查詢價格與收據,並按次以 USDC 付費取得 Base 代幣、合約與鏈上狀態的答案。

可以做什麼
查看能力目錄,查詢某次特定呼叫的參考價格與重用層級,並核對已結算呼叫實際收取的費用,全部免費且不需要錢包。讀取 Base 代幣的名稱、符號、精度與總供應量,取得最新區塊、基礎費用與建議 gas,並檢查合約是否為可執行程式碼及是否有代理或暫停訊號。將其他代理提供的 artifactId 解析為生產者、有效期間與重現輸入,並提交自行計算的合約位元碼指紋以成為播種者。為希望日後付費的能力登記免費的需求承諾。
適用情境
當助理在簽署或與 Base 合約互動前,需要可驗證、具有效期限的代幣、合約或鏈上狀態答案時使用;也適合在付費前先查看價格與重用層級。免費的目錄、價格與收據工具即使沒有付款設定也能使用。
執行需求
可作為本機 npm 套件透過 npx 執行,也可作為遠端端點供支援遠端 MCP 的用戶端連線。付費工具透過 x402 在 Base 上按次以 USDC 結算;在 stdio 下需對付款挑戰簽章並透過 HTTP 請求資源位址完成付款,因為 stdio 無法回傳付款簽章。選用環境變數:TERENO_WALLET、TERENO_BASE_URL、TERENO_TIMEOUT_MS、TERENO_EVIDENCE_INSTALLATION_ID。
安裝前請注意
付費工具每次呼叫都會在 Base 上花費真實 USDC,應設定預算並先用 tereno_price 查詢價格。此套件本身不讀取或儲存私鑰,但付款需要由 x402 用戶端以你的錢包簽章。提交位元碼指紋免費且無需 gas,但會與鏈上狀態重新比對,不符即作廢。探索、評分、定價與全域快取位於閉源後端,除交易意圖檢查外答案會在代理之間共享。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Tereno on Base,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/xyz.tereno%2Ftereno/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "tereno-on-base": {
      "type": "http",
      "url": "https://www.tereno.xyz/api/mcp"
    }
  }
}

README

[Tereno]

tereno-mcp

🛡️ Check before you act — an MCP server for Base, over x402

Ask what it costs before you pay for it. Free catalog, pricing and receipt tools work with no wallet and no signup; paid answers settle per call in USDC, and reusing an answer another agent already paid for costs less.


[npm version] [MCP] [Base] [x402]

[license] [no dependencies] [free tier]

bash
npx -y tereno-mcp

⚡ Why this exists

An agent that reads a contract, signs a transaction or scrapes a page is acting on information it cannot verify. Most tools answer what something is. None of them tell you how long that answer stays true.

tereno-mcp puts Tereno inside any MCP client. Every paid answer comes back with the evidence behind it, the limits of that evidence, and the block it stops being valid at.

  • No API key, no signup. The agent's wallet is the identity.
  • Price before payment. tereno_price tells you the cost and whether the answer already exists, without a wallet and without committing to anything.
  • Cheaper when shared. Deterministic answers are reused across agents: the first caller pays to compute, everyone after pays the reuse price.

🚀 Install

Add it to any MCP client — Claude Desktop, Claude Code, Cursor, Cline, Windsurf:

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

Restart the client. Nothing else to configure — the free tools work immediately.

🆓 Free, no wallet needed

ToolThe question it answers
📖 tereno_catalogWhat can Tereno answer, what does it cost, how long does each answer stay valid?
🏷️ tereno_priceWhat would this exact call cost right now — and does the answer already exist?
🧾 tereno_receiptWhat did a settled call actually charge: tier, list price, credit applied, price paid?

tereno_price is the one worth knowing about. It names the reuse tier out loud:

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

💳 Paid per call

ToolPriceThe question it answers
🚦 transaction_intent_guard$0.005Is this safe to sign? Simulation, gas, balance and allowance deltas, unlimited-approval flags
🛡️ contract_guard$0.001–3Is this contract safe to interact with? (code, proxy, pause)
🕵️ contract_change$0.001–2Did it change since last look? (rug-pull-after-audit detector)
🪙 token_metadata$0.001–3What token is this, really? (name, symbol, decimals, supply)
🧬 contract_interface$0.001–2ERC-20? NFT? Proxy? One bounded probe
⛽ chain_snapshot$0.001–2Latest Base block, base fee and suggested gas, zero parameters
📄 web_compile$0.001–5Public URL → bounded Markdown with resolved links, citations and a reusable artifact
🔎 evidence_artifact$0.001–3Can this public artifact be reused? Provenance, field validity, recomputation input
🤝 demand_pledgefreeName a capability you would pay for. Credit only after the same wallet pays for it later

Calling a paid tool returns a 402 carrying the payment challenge in error.data.paymentRequired, the payable resource URL in error.data.resource, and the terms (network, asset, amount, payTo) in error.data.offer.

Over stdio you cannot pay by retrying the tool call. stdio has no headers in either direction, so there is nowhere for a PAYMENT-SIGNATURE to travel back through. Two ways to settle, both of which leave this package never touching a private key:

  • Pay the resource over HTTP. Sign error.data.paymentRequired with your x402 client and send the signed request to error.data.resource. It returns the same payload the tool would have, receipt included, billed once.
  • Use the remote server instead of this package. If your client supports remote MCP, point it at https://www.tereno.xyz/api/mcp. That transport does have headers, so signing the challenge and retrying the same tool call is the normal flow and everything stays inside MCP.

🔒 transaction_intent_guard is never cached, shared or resold. An unsigned transaction is intent, and it stays with the wallet that paid for it.

⚙️ Configuration

EnvDefaultPurpose
TERENO_WALLET—Base address announced before payment, so a challenge can be bound to the wallet that will settle it. Optional.
TERENO_BASE_URLhttps://www.tereno.xyzPoint at another Tereno deployment.
TERENO_TIMEOUT_MS45000Upstream request timeout.
TERENO_EVIDENCE_INSTALLATION_ID—Optional stable random id for this MCP installation. It is hashed only when resolving evidence received from another agent; never use a wallet or secret.

🔐 What this package does and does not do

It is a stdio transport in front of the hosted endpoint at /api/mcp. Messages are forwarded verbatim, so the tool list, the prices and the payment challenge all come from the same place an HTTP agent sees — and this package needs no release when a capability changes.

The one thing it translates is payment, and the translation is lossy in one direction. Over HTTP the challenge arrives in a response header and the caller retries with a PAYMENT-SIGNATURE header. stdio has neither, so the challenge is folded into the JSON-RPC error payload where a client can still reach it, while the signature has no way back in. That is why a paid call is settled against the resource URL rather than by retrying the tool, and why a client that speaks remote MCP should prefer the hosted endpoint.

No private key is ever read, stored or transmitted. There are no dependencies, and the whole thing is one readable file — read it before you let it run on your machine.

If your client supports remote MCP servers, skip this package and point it straight at https://www.tereno.xyz/api/mcp.

🌱 How it stays cheap — the cooperative layer

Tereno is a shared-cache coordination layer, not just an API. The first agent to pay for a given piece of verified work seeds it for the whole network; every later agent that reuses that answer pays less, and the seeder earns a small, non-transferable credit that discounts its own future calls.

Safety is a public good with a private cost. By making the first computation earn from every reuse, the network turns "I paid to check this contract" into "I lowered the price of checking it for everyone, and my own checks got cheaper."

The honest fine print: rewards are non-transferable credits, capped per artifact. They fund your agent's budget, they are not yield.

Discovery, scoring, reputation, pricing and the global cache live in the closed Tereno backend. This server and its SDK (tereno-client) are the public, open interface to it.

🤝 Support & community

🔗 Links

Live catalog · OpenAPI · MCP registry entry · plugin-tereno for ElizaOS · tereno-client SDK


tereno.xyz · Verdicts before signatures, for agents on Base.

來源:README.md,提交 bda500c

工具

10

tereno_catalog

What can Tereno answer, and what does it cost?

Free. The full capability catalog: what each one answers, its price tiers in USDC on Base, how long an answer stays valid, and whether it is shared or private. Read this before paying for anything.

無需輸入參數。

tereno_price

What would this call cost right now?

Free. Indicative price and reuse tier for one specific input, without binding a quote or revealing a wallet. Returns hit when another agent already paid to compute this and it is still fresh, partial when only the durable half survives, miss when nothing is there to reuse. The gap between those tiers is what reuse is worth.

輸入參數addressquestioncapability必填

tereno_receipt

Verify a Tereno receipt

Free. Look up what a settled invocation actually charged: capability, version, cache tier, list price, credit applied, price paid and whether it settled on chain. Use it to check that a call you or another agent paid for was billed the way it was quoted.

輸入參數invocationId必填

tereno_evidence_reference

Read a portable Tereno evidence reference

Free. Resolve an artifactId another agent handed you: producer, validity window and the exact normalized input needed to reproduce it. Supply a stable opaque installationId to participate in the cross-agent reference experiment; it is hashed, deduplicated daily and never creates payment or credit.

輸入參數channelartifactId必填installationId

tereno_publish

Publish work you already computed, and get it attested on-chain

Free, no payment and no gas. Submit a contract bytecode fingerprint you computed yourself. Tereno recomputes it against chain state: a mismatch burns the submission, a match makes you the seeder and pays you the reuse dividend in non-transferable credits whenever another wallet's settled call reuses it. Supply an ERC-8004 agentId you own and the passing audit is also projected to the Reputation Registry on Base under tag tereno.audit. No agentId yet? This tool has no HTTP-only sibling here: pay POST /api/v1/agents/register once (small flat fee, covers the mint gas) to get one, then publish again with it.

輸入參數wallet必填address必填agentIdbytecodeHashbytecodeBytescomputedAtBlock必填registerIfMissing

token_metadata

What token is this?

What token is this? Read a Base token's name, symbol, decimals and total supply as one typed, cache-shared answer with block-level freshness. Paid per call with x402 on Base: $0.01 to $0.03 USDC depending on how much of the answer the network already has. Shared: reusing an answer another agent already paid for costs less, and the wallet that produced it earns a bounded credit.

輸入參數address必填

chain_snapshot

What is the current state of Base?

What is the current state of Base? Latest block number, timestamp, base fee and suggested gas fees in a single cheap call — no parameters required. Paid per call with x402 on Base: $0.002 to $0.005 USDC depending on how much of the answer the network already has. Shared: reusing an answer another agent already paid for costs less, and the wallet that produced it earns a bounded credit.

無需輸入參數。

contract_guard

Is this Base contract safe to interact with?

Is this Base contract safe to interact with? Check whether an address is executable code, detect common proxy and pause signals, and return a bounded action verdict. Paid per call with x402 on Base: $0.02 to $0.1 USDC depending on how much of the answer the network already has. Shared: reusing an answer another agent already paid for costs less, and the wallet that produced it earns a bounded credit.

輸入參數address必填

prediction_evidence

Gather sourced machine-readable evidence supporting or contradicting a prediction market proposition

Returns current, sourced and machine-readable evidence supporting or contradicting a prediction-market proposition. Paid per call with x402 on Base: $0.01 to $0.05 USDC depending on how much of the answer the network already has. Shared: reusing an answer another agent already paid for costs less, and the wallet that produced it earns a bounded credit.

輸入參數marketcontextquestion必填marketUrl

demand_pledge

Declare a capability you would pay for

Free market-signal pledge. It earns no credit now; a bounded non-transferable credit is released only if this same wallet later settles the named capability after it exists.

輸入參數wallet必填capability必填

版本歷史

1
  1. v0.1.3最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分