reputation

@tradallo/reputation

Tradallo Verified Record Protocol 用の MCP サーバー ＋ TypeScript クライアント ＋ CLI です。暗号学的に検証された人間およびエージェントの取引記録を照会する 3 つの方法を提供します。

# CLI — pretty terminal cards, no install required
npx @tradallo/reputation card alpha-momentum-v3 --agent

# MCP — drop into Claude Desktop / Cursor / any MCP client (config below)

# Programmatic — typed TS/JS client
import { TradalloClient } from "@tradallo/reputation";

すべてのレスポンスは、クライアントに返される前に、tradallo.com/.well-known/tradallo-pubkeys.json で公開されている Tradallo の公開鍵を使って JCS 正規化および ed25519 検証されます。署名はエンベロープに含まれます。このクライアントは公開鍵レジストリを取得し、key_id を特定して署名を検証してから、データを返します。served_at と max_age_seconds によるリプレイ保護も行います。

インストール

Claude Desktop

claude_desktop_config.json に追加します（Settings → Developer → Edit Config）。

{
  "mcpServers": {
    "tradallo-reputation": {
      "command": "npx",
      "args": ["-y", "@tradallo/reputation"]
    }
  }
}

Claude Desktop を再起動します。ツールパレットに Tradallo のツールが表示されます。

Cursor

~/.cursor/mcp.json に追加します（または Cursor Settings → MCP から追加します）。

{
  "mcpServers": {
    "tradallo-reputation": {
      "command": "npx",
      "args": ["-y", "@tradallo/reputation"]
    }
  }
}

汎用 MCP クライアント

npx @tradallo/reputation

stdio 経由で MCP と通信します。

ローカル開発／ステージング

TRADALLO_BASE_URL を設定して、独自のデプロイ先を指定します。

{
  "mcpServers": {
    "tradallo-reputation": {
      "command": "npx",
      "args": ["-y", "@tradallo/reputation"],
      "env": { "TRADALLO_BASE_URL": "http://localhost:3000" }
    }
  }
}

CLI

サブコマンドを指定して実行すると、同じバイナリをターミナル CLI としても使用できます。

# Pretty card with verification status, stats, version metadata
npx @tradallo/reputation card alpha-momentum-v3 --agent

# Raw verified JSON (for piping into jq, etc.)
npx @tradallo/reputation track-record alpha-momentum-v3 --agent

# Discovery
npx @tradallo/reputation search --min-sharpe 1.5 --min-trades 200 --sort-by sharpe

# Agent version history
npx @tradallo/reputation versions alpha-momentum-v3

# Paginated UTRs
npx @tradallo/reputation utrs alpha-momentum-v3 --limit 50

# Look up a specific UTR by hash
npx @tradallo/reputation verify <sha256-hex> alpha-momentum-v3

# Help
npx @tradallo/reputation help

NO_COLOR=1 で ANSI を無効にします。TRADALLO_BASE_URL で API のベース URL を上書きします。

プログラムからのクライアント利用

検証クライアントを独自の TS/JS コードに組み込みます。

import { TradalloClient } from "@tradallo/reputation";

const client = new TradalloClient(); // defaults to https://tradallo.com

// Throws if signature invalid, replay window expired, or pubkey unknown.
// Returns the verified `data` payload (not the envelope wrapper).
const record = await client.getSigned<{ stats: { all_time: { sharpe_ratio: number | null } } }>(
  "/api/v1/agents/alpha-momentum-v3/track-record",
);

if ((record.stats.all_time.sharpe_ratio ?? 0) >= 1.5) {
  // ... delegate capital, copy trades, etc.
}

検証処理は getSigned の内部で行われます。不正な署名、期限切れのエンベロープ、不明な鍵、スキーマの不一致など、問題が発生した場合は呼び出し時に例外がスローされます。検証されていないデータを目にすることはありません。

ツール

get_track_record(handle, principal_type?)

Tradallo のプロフィールまたはエージェントの検証済み取引記録を取得します。

入力：

• handle（string、必須）— Tradallo のハンドル（例：aaronjordan、alpha-momentum-v3）
• principal_type（"human" | "agent"、省略可、デフォルトは "agent"）— 検索する名前空間

戻り値： 完全な署名付きペイロード（検証レベル、全期間および直近 30／90／365 日の統計。Sharpe、最大ドローダウン、勝率、PnL、期待値を含む）。

使用例：

「Tradallo 上の Aaron Jordan の検証済み取引記録を表示してください。」

search_records(filters)

パフォーマンス条件に一致する検証済み記録を検索します。

入力（すべて省略可）： min_sharpe、min_trades、max_drawdown、venue、principal_type、sort_by、limit。

戻り値： 統計情報を含む、人間／エージェントの概要を並べ替えたリスト。署名検証済みです。

verify_utr(utr_hash)

ハッシュを指定して Universal Trade Receipt を検索します。Tradallo が Solana の memo を使ってそのハッシュをオンチェーンに記録しているかどうかを返します。記録されている場合は、チェーン、署名、slot、posted_at、Solana Explorer の URL、notarizer の公開鍵も返すため、呼び出し元がオンチェーンで独立して検証できます。

戻り値： { found, anchored_on_chain, chain?, signature?, slot?, posted_at?, explorer_url?, notarizer_pubkey? }。

get_versions(agent_handle)

エージェントの完全なバージョン履歴を取得します（semver タグ、version_hash、policy_hash、各バージョンのデプロイ日時および置き換え日時）。署名検証済みです。

get_utrs(agent_handle, since?, limit?)

エージェントの未加工の Universal Trade Receipt を取得します。closed_at によるカーソル方式でページネーションされます。各レシートには Tradallo が再計算した SHA-256 ハッシュが含まれるため、利用者は個々の記録を抜き取り検査できます。

検証の仕組み

署名付きの Tradallo API レスポンスはすべて、データを JCS 正規化（RFC 8785）したエンベロープに格納し、ed25519 署名を付与します。

{
  "data": { ... },
  "schema_version": "1",
  "served_at": "2026-04-30T22:29:52.776Z",
  "max_age_seconds": 60,
  "signature": {
    "alg": "ed25519",
    "key_id": "tradallo-prod-2026-04",
    "sig": "<base64>"
  }
}

この MCP サーバーは次の処理を行います。

1. /.well-known/tradallo-pubkeys.json を取得します（5 分間キャッシュ）。
2. signature.key_id を解決し、ed25519 公開鍵を取得します。
3. {data, schema_version, served_at, max_age_seconds} を JCS 正規化します。
4. 公開鍵を使って署名を検証します。
5. now > served_at + max_age_seconds となるレスポンスを拒否します（リプレイ保護）。

いずれかの検査に失敗した場合、ツール呼び出しはデータではなくエラーを返します。エージェントには理由が通知されます。

これが重要な理由

アイデンティティ（エージェントは誰か）と決済（どのように支払うか）は、2026 年には x402、MPP、Coinbase Agentic Wallets、ERC-8004 によって解決されています。評判はまだ解決されていません。 エージェントが資金を委任するか、トレードをコピーするか、他の当事者のシグナルを購読するかを判断する際には、「その実績は本物か」を確認する方法が必要です。

この MCP サーバーは、その問いを最も手軽に確認する方法です。

x402 — 今後の予定

現在、公開 API は匿名で利用でき、IP ごとにレート制限（60 req/min）があります。登録や API キーの手続きなしに、エージェントが Base 上で USDC の少額決済を行い、レート制限を回避してより高いスループットのプランを利用できるよう、HTTP 402 決済要求標準の x402 による段階的なアクセスを順次導入しています。

将来の互換性を考慮した想定：

• 匿名：60 req/min/IP（現在、無料）
• 有効なサブスクライバー：API キー経由で 600 req/min（開発中 — Phase 4.4）
• x402 少額決済：1 回限りの高負荷クエリ向けの呼び出しごとの USDC 決済。アカウント不要（Phase 4.5 で導入予定）
• オペレーター／フリートプラン：Webhook サブスクリプション、カスタムサブドメイン、優先インデックス作成

ファシリテーターのパイプラインが接続されると、レート制限レスポンスに x402 決済オプションのブロックが追加されます。この MCP サーバーは、x402 メタデータを含む 402 を検出すると、自動的に支払いを開始するようになります。それまでは、すべてのクエリを無料で利用でき、検証可能です。

参照エージェント

資金を委任する前に Tradallo を照会する、動作するエージェントの例： github.com/tradallo/agent。

仕様とドキュメント

• プロトコル概要：docs/PROTOCOL.md
• 仕様：docs/SPEC_V1.1.md
• 公開 API：https://tradallo.com/api/v1/
• 公開鍵レジストリ：https://tradallo.com/.well-known/tradallo-pubkeys.json

変更履歴

CHANGELOG.md を参照してください。

ライセンス

MIT