Agentic Terminal Directory

AT Directory

让 Agent 在 Bitcoin 和 Tether 实际使用的支付轨道上发现经 OP 验证的商家。

AT Directory 为销售产品、服务、API 或内容，并接受 Lightning、BOLT12、L402 或 USDT（任意链）的商家建立索引，这些商家的信任证明由 Observer Protocol 签发。它是构建在碎片化的 Agent 支付生态之上的、经过验证且可由 Agent 调用的层。它不参与支付流程——Agent 在此发现商家，然后直接向商家付款。

• MCP 服务（主要产品）— @agenticterminal/mcp-server，托管于 mcp.agenticterminal.ai。
• Web 目录 — agenticterminal.ai，以同一份数据呈现给人类用户。
• SKILL.md — 教会 Agent 如何查询并完成支付交接。

状态

v1 发布前，正在积极开发。目标：在 2026-05-18 当周完成 Tether 会议演示。v1 将推出 Tier 1–2。

在 Agent 中使用

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

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

六个工具：search_merchants、get_merchant、verify_payment_endpoint、list_categories、list_rails、whoami。读取操作不设访问限制——匿名 Agent 可以查看所有等级，并且无需设置即可进行交易。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

数据模型

每个商家都有两个相互独立的信号——请同时查看：

• OP 信任等级（商家）：1 自我声明 · 2 运营方验证。v1 中的 Tier 2 表示 AT 运营方已完成交易并确认；双向交易对手证明模型将在 v1.x 上线。
• Agent 可调用等级（集成）：full-api · structured-handoff · human-checkout。

**信任等级不会限制任何操作。**读取操作不设访问限制，匿名 Agent 可以查看所有等级， Agent 无需任何设置即可与 Tier 1 商家进行交易。该等级只是供调用方权衡的证据， 而非本目录代替调用方作出的决定。不会因该等级而拒绝任何操作。

CI（pnpm validate-data）和每次加载时都会验证架构。USDT 支付轨道必须指定 chain；Tier 2 及以上的非集成记录必须包含 op_attestation_url；导入时会拒绝 op_trust_tier 为 3 的记录，因此上述模型的最高等级为 2。

参与贡献

请参阅 CONTRIBUTING.md。商家和研究人员可通过电子邮件向 [email protected] 提交申请；获接受的条目在验证前会列为 Tier 1。

/submit 上的自助注册表单目前无法使用。 自 883c183 起（2026-06-22，该提交取代了早期的 GitHub issue 表单），apps/web/app/submit/page.tsx 中的 TALLY_FORM_ID = 'TODO' 一直未变，后续也没有提交修改过它，因此该页面会显示电子邮件备用选项，且不会嵌入表单。 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。