Agentic Terminal Directory

AT Directory

エージェントが、Bitcoin と Tether が実際に利用するレール上で、OP によって検証済みの加盟店を見つけられる場所です。

AT Directory は、Lightning、BOLT12、L402、または USDT（あらゆるチェーン）での支払いを受け付け、製品、サービス、API、コンテンツを販売する加盟店を、Observer Protocol を通じて発行された信頼証明とともにインデックス化します。断片化したエージェント決済の状況における、検証済みでエージェントから呼び出し可能なレイヤーです。決済経路には含まれません。エージェントはここで加盟店を見つけ、加盟店に直接支払います。

• MCP サーバー（主力製品）— @agenticterminal/mcp-server。mcp.agenticterminal.ai でホストされています。
• ウェブディレクトリ — agenticterminal.ai。同じデータを人間向けに表示します。
• SKILL.md — エージェントがクエリを実行し、決済を引き継ぐ方法を説明します。

ステータス

v1 リリース前、開発進行中です。Tether とのミーティングでライブデモを行う目標日は 2026-05-18 の週です。v1 では Tier 1〜2 をリリースします。

エージェントから利用する

// Hosted (recommended, no install)
{ "mcpServers": { "at-directory": { "url": "https://mcp.agenticterminal.ai/mcp" } } }

npm install -g @agenticterminal/mcp-server   # local alternative

6 つのツール：search_merchants、get_merchant、verify_payment_endpoint、list_categories、list_rails、whoami。読み取りは認証不要です。匿名エージェントはすべての Tier を確認でき、設定なしで取引できます。Observer Protocol の DirectoryAccessCredential を使うと、レート制限が緩和され、書き込みアクセス（レビュー）が可能になりますが、加盟店の検索や取引に必須ではありません。詳細なリファレンス：agenticterminal.ai/api-docs。

リポジトリの構成

data/merchants/         One JSON file per merchant (the source of truth).
data/schema/            JSON Schema (Draft 2020-12) for merchant records.
data/categories.json    Category taxonomy.
data/rails.json         Supported rails + USDT chains.
data/LOGO-AUDIT.md      Logo sourcing checklist.
packages/core/          Types, schema-validated load, search/filter.
packages/mcp-server/    stdio + hosted HTTP MCP server, rail verification.
packages/skill/         SKILL.md (canonical).
apps/web/               Next.js static directory + Netlify Functions.
deploy/mcp-server/      Dockerfile, systemd unit, DEPLOY runbook.
scripts/                Data validation (and one-time crawl tooling).

開発

pnpm install
pnpm -r test          # core + mcp-server unit/integration tests
pnpm -r typecheck
pnpm validate-data    # schema-validate every merchant record
pnpm -F @at-directory/web dev          # web at localhost:3000
pnpm -F @agenticterminal/mcp-server start:stdio   # MCP over stdio

モック検証ツールを使ってローカルで MCP を実行します（実際の AT ルートが追加されるまで）：

pnpm -F @agenticterminal/mcp-server exec tsx src/dev/mock-verifier.ts &
AT_VERIFIER_URL=http://127.0.0.1:8787 \
  pnpm -F @agenticterminal/mcp-server start:stdio

データモデル

各加盟店には、相互に独立した 2 つのシグナルがあります。両方を確認してください。

• OP 信頼 Tier（加盟店）：1 自己申告・2 運営者による検証済み。v1 の Tier 2 は、AT 運営者が取引して確認済みであることを意味します。二者間で相手方が証明を発行するモデルは v1.x で導入されます。
• エージェント対応 Tier（インテグレーション）：full-api・structured-handoff・human-checkout。

信頼 Tier による制限はありません。 読み取りに認証は不要で、匿名エージェントにもすべての Tier が表示され、エージェントは設定なしで Tier 1 の加盟店と取引できます。Tier は呼び出し側が判断材料として評価するための証拠であり、このディレクトリが代わりに下した判断ではありません。Tier を理由に拒否されることはありません。

スキーマは CI（pnpm validate-data）および読み込みのたびに検証されます。USDT レールには chain が必須です。Tier 2 以上の非統合レコードには op_attestation_url が必須です。op_trust_tier が 3 のレコードは取り込み時に拒否されます。そのため、上記のモデルは Tier 2 までとなっています。

コントリビューション

CONTRIBUTING.md を参照してください。加盟店および研究者は、メールで [email protected] に申請できます。承認されたエントリーは、検証が完了するまで Tier 1 に登録されます。

/submit の自己登録フォームは稼働していません。 apps/web/app/submit/page.tsx の TALLY_FORM_ID = 'TODO' は、883c183（2026-06-22。以前の GitHub issue フォームを置き換えた変更）以降そのままで、以降のコミットでも変更されていません。そのため、このページにはメールでの代替手段が表示され、フォームは埋め込まれていません。apps/web/netlify/functions/submit-merchant.ts は存在し、実装も完了していますが、Netlify 環境で TURNSTILE_SECRET_KEY、GITHUB_APP_ID、GITHUB_APP_PRIVATE_KEY、GITHUB_INSTALLATION_ID を設定する必要があります。これらが設定されているかどうかを示すものは、このリポジトリにはありません。それにもかかわらず、この README と CONTRIBUTING.md では、2026-09-15 に受信した報奨金申請で指摘されるまで、フォームを利用可能な申請方法として案内していました。フォーム ID を設定し、テスト申請によって実際に PR が作成されたことを確認するまで、再び案内しないでください。

ドキュメント

• スコープ — 位置づけ、対象基準、完了の定義。
• 仕様 — 実装の契約。

ライセンス

MIT。