Trust Layer

開發者 — Trust Layer API 與 MCP

把智能體卡片接入你的大模型、Agent 執行環境或垂直助手：搜尋、查證、調用真實商家。

智能體卡片（Agent Card）

機讀身分單元。/t 與 /b 共用同一 ID。API 版本 2026-08-21。

MCP 工具

POST /api/mcp 的 JSON-RPC：search_agents、get_agent、verify_agent、get_business_facade、search_registry、get_merged_profile（香港登記庫首選）。

HTTP v1

GET /api/v1/search · /api/v1/t/{id} · /api/v1/verify · /api/v1/b/{handle} · /api/v1/registry/{id}/merged

API Key

公開讀有 IP 限流。更高量請在 Dashboard 建立 Bearer Key。

Agent Trust Stack（開源）

Trusgent 在產 dogfood 四套開放協議 — AgentID、AgentCert、AgentLedger、trusgent-mcp。我們是參考簽發方；請驗簽 VC，不要只信 HTML。

AgentID

did:agent 身分

AgentCert

W3C VC 信任等級

AgentLedger

簽名聲譽事件

trusgent-mcp

MCP manifest

npm：@trusgent/agentcert-verify

Verify API Issuer 公鑰 Verify API (UI)

香港官方登記庫

6 萬+ 條結構化登記記錄——食肆、診所、律師、保險等。每條登記頁連結官方 JSON；有 enrichment 時還可讀取合併檔案。

HTTP

GET /api/v1/registry/{registryId} · GET /api/v1/registry/{registryId}/merged · GET /api/v1/registry/search

MCP：get_registry · search_registry · get_merged_profile

合併檔案（Merged Profile）

合併官方登記欄位、已認領 Agent Card（如有）與帶出處的第三方。返回 dossierLayers、citationPolicy、trustBreakdown 與 recommendedUse，便於 Agent 判斷哪些欄位可引用。

欄位來源分層

分層建檔：官方登記最高權重；本人認領的結構化欄位可追責；帶出處的第三方須含來源 URL 與抓取時間；評論只作輔助。Trust Score 是身分核驗 + 官方記錄 + 資料完整度 + 來源一致性，不是全網感覺分。不做無授權的全網評論倉庫。

伺服端配置 GOOGLE_PLACES_API_KEY 後啟用真實 Places enrichment；香港商戶僅拉取電話 / 營業時間 / 評分 / Maps URL，按 place_id 快取，頁面與 MCP 讀取不即時打 API。未配置時使用 demo 資料。

預設對接路徑（香港登記庫）

夥伴 Agent 在 search_registry 之後，應預設調用 get_merged_profile（或 GET /api/v1/registry/{registryId}/merged）。僅當需要純官方欄位、不含 enrichment 與認領上下文時，才用 get_registry。

search_registry — 依名稱、地址或牌照編號搜尋
get_merged_profile — 讀取官方 + 認領 + enrichment，並取得 recommendedUse
若 claimed.trusgentId 存在：推薦前調用 verify_agent；可選 get_business_facade
recommendedUse.identity 為 safe_to_cite 時可引用身份；hours/contact 依 recommendedUse 分級引用

合併檔案示例

{
  "kind": "MergedRegistryProfile",
  "apiVersion": "2026-05-01",
  "registryId": "fehd-3715038328",
  "official": {
    "verification": {
      "level": "REGISTRY_OFFICIAL"
    }
  },
  "claimed": null,
  "enrichment": {
    "status": "PENDING_REVIEW",
    "layer": "THIRD_PARTY_CITED",
    "fetchedAt": "2026-08-24T00:00:00.000Z",
    "fields": {
      "hours": {
        "verificationLevel": "INFERRED",
        "source": "google_places",
        "fetchedAt": "2026-08-24T00:00:00.000Z",
        "layer": "THIRD_PARTY_CITED"
      }
    }
  },
  "dossierLayers": [
    {
      "layer": "OFFICIAL_REGISTRY",
      "weight": "highest",
      "present": true
    }
  ],
  "trustBreakdown": {
    "officialRegistry": 40,
    "merchantClaim": 0,
    "enrichmentConfirmed": 2,
    "totalHint": 42,
    "auxiliaryReviews": 0,
    "formulaVersion": "2026-08-24"
  },
  "recommendedUse": {
    "identity": "safe_to_cite",
    "hours": "cite_with_caution",
    "contact": "do_not_cite"
  }
}

登記庫索引搜尋全部記錄閱讀整合指南

建立 API Key 查看 MCP 端點 OpenAPI JSON 夥伴 / BD

打開 Agent Card 契約: docs/agent-card.md · MCP 指南: docs/mcp.md · Quickstart 指南: docs/agent-trust-stack-quickstart.md