Tereno on Base

---

⚡ このツールが生まれた理由

コントラクトを読み、トランザクションに署名し、ページをスクレイピングするエージェントは、検証できない情報に基づいて行動しています。ほとんどのツールは、何であるかには答えます。しかし、その回答がどれくらいの間有効なのかを教えてくれるツールはありません。

tereno-mcp は、Tereno をあらゆる MCP クライアントで使えるようにします。有料の回答にはすべて、その根拠となる証拠、その証拠の限界、そして回答が有効でなくなるブロックが付属します。

• API キーも登録も不要です。 エージェントのウォレットが、そのまま身元を示します。
• 支払いの前に料金を確認できます。 tereno_price を使えば、ウォレットなしで、また何かに同意する必要もなく、料金と回答がすでに存在するかどうかを確認できます。
• 共有すると料金が安くなります。 決定論的な回答はエージェント間で再利用されます。最初の呼び出し元が計算費用を支払い、それ以降の呼び出し元は再利用料金を支払います。

🚀 インストール

Claude Desktop、Claude Code、Cursor、Cline、Windsurf など、あらゆる MCP クライアントに追加できます。

{
  "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	これは安全に署名できますか？ シミュレーション、ガス、残高と承認額の差分、無制限承認フラグ
🛡️ contract_guard	$0.001–3	このコントラクトと安全にやり取りできますか？（コード、プロキシ、一時停止）
🕵️ contract_change	$0.001–2	前回確認したときから変更されていますか？（監査後のラグプル検出ツール）
🪙 token_metadata	$0.001–3	これは実際にはどのトークンですか？（名前、シンボル、小数桁数、供給量）
🧬 contract_interface	$0.001–2	ERC-20？NFT？プロキシ？範囲を限定したプローブを1回実行
⛽ chain_snapshot	$0.001–2	最新の Base ブロック、基本手数料、推奨ガス量。パラメーター不要
📄 web_compile	$0.001–5	公開 URL → 解決済みリンク、引用、再利用可能なアーティファクトを含む、範囲を限定した Markdown
🔎 evidence_artifact	$0.001–3	この公開アーティファクトは再利用できますか？出所、フィールドの有効性、再計算の入力
🤝 demand_pledge	無料	支払いを希望する機能を提示します。同じウォレットが後でその機能に支払った場合にのみクレジットされます

有料ツールを呼び出すと、支払いチャレンジが error.data.paymentRequired に、 支払い対象のリソース URL が error.data.resource に、利用条件（ネットワーク、 アセット、金額、payTo）が error.data.offer に含まれた 402 が返されます。

stdio では、ツール呼び出しを再試行して支払うことはできません。 stdio には どちらの方向にもヘッダーがないため、PAYMENT-SIGNATURE を返す経路がありません。 決済方法は2つあります。どちらの場合も、このパッケージが秘密鍵に触れることは ありません。

• HTTP 経由でリソースに支払います。 x402 クライアントで error.data.paymentRequired に署名し、署名済みリクエストを error.data.resource に送信します。レシート付きで、ツールが返すものと同じ ペイロードが返され、課金は1回です。
• このパッケージの代わりにリモートサーバーを使います。 クライアントが リモート 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 です。別のエージェントから受け取ったエビデンスを解決する場合にのみハッシュ化されます。ウォレットや秘密情報は使用しないでください。

🔐 このパッケージが行うことと、行わないこと

これは、ホストされたエンドポイント /api/mcp の前段に置かれる stdio トランスポート です。メッセージはそのまま転送されるため、ツール一覧、価格、支払いチャレンジは すべて HTTP エージェントが見るものと同じ場所から取得されます。機能が変わっても、 このパッケージをリリースし直す必要はありません。

変換されるのは支払いだけで、その変換は一方向に情報が失われます。HTTP では チャレンジはレスポンスヘッダーで届き、呼び出し側は PAYMENT-SIGNATURE ヘッダーを 付けて再試行します。stdio にはどちらもないため、チャレンジはクライアントが参照できる JSON-RPC エラーペイロードに格納されますが、署名を返す方法はありません。そのため、 有料の呼び出しはツールを再試行するのではなくリソース URL に対して決済し、 リモート MCP に対応するクライアントにはホストされたエンドポイントの利用を推奨します。

秘密鍵が読み取られたり、保存されたり、送信されたりすることはありません。 依存関係はなく、全体が読みやすい1つのファイルで構成されています。お使いのマシンで 実行する前に、コードを読むことができます。

クライアントがリモート MCP サーバーに対応している場合は、このパッケージを使わず、 https://www.tereno.xyz/api/mcp に直接接続してください。

🌱 コストを抑えられる仕組み — 協調レイヤー

Tereno は単なる API ではなく、共有キャッシュの調整レイヤーです。検証済みの作業に最初に対価を支払ったエージェントが、その結果をネットワーク全体で利用できるようにします。その回答を再利用する後続のエージェントは支払いが少なくなり、最初に提供したエージェントは、自身の今後の呼び出しを割り引く、譲渡不可の少額クレジットを獲得します。

安全性は公共財ですが、そのコストは個人が負担します。最初の計算が再利用のたびに報酬を生む仕組みによって、ネットワークは「この契約の確認に費用を払った」を「この契約を確認する費用を誰にとっても下げ、自分の確認コストも下がった」へと変えます。

正直にお伝えすると、報酬は譲渡不可のクレジットで、アーティファクトごとに上限があります。クレジットはエージェントの予算に充てられるものであり、利回りではありません。

検出、スコアリング、レピュテーション、価格設定、グローバルキャッシュは、非公開の Tereno バックエンドで管理されています。このサーバーとその SDK (tereno-client) は、そのバックエンドへの公開されたオープンなインターフェースです。

🤝 サポートとコミュニティ

• 💬 質問／セットアップ → Tereno Discord
• 🐛 バグ → issues · ⚠️ 秘密鍵や .env は絶対に貼り付けないでください
• 🔒 脆弱性 → 非公開で報告

🔗 リンク

ライブカタログ · OpenAPI · MCP レジストリエントリー · ElizaOS 用 plugin-tereno · tereno-client SDK

---