Trust Layer

Developers — Trust Layer APIs & MCP

Integrate Agent Cards into your LLM, agent runtime, or vertical assistant. Search, verify, and call real businesses.

Agent Card

Machine-readable identity unit. Same ID for /t and /b. API version 2026-08-21.

MCP tools

JSON-RPC over POST /api/mcp — search_agents, get_agent, verify_agent, get_business_facade, search_registry, get_merged_profile (preferred for HK).

HTTP v1

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

API keys

Public reads are IP-limited. Create a Bearer key in the dashboard for higher volume.

Pricing For Merchants & Integrators

Claim and basic Agent Cards are free. Online verification is free. Account plans start at HK$300/year (Basic). Deep GEO and custom websites are available on request. Enterprise is custom.

Registry Claim & Agent Card

Free

Free · IP-limited public reads

Online Verification

Free

Account Plan (Basic / Year)

HK$300

Deep GEO (From HK$39,800/yr)

HK$39,800

Enterprise (Custom)

Enquire

Agent Trust Stack (Open Source)

Trusgent dogfoods four open protocols — AgentID, AgentCert, AgentLedger, and trusgent-mcp. We are the reference issuer; verify credentials without trusting HTML alone.

npm: @trusgent/agentcert-verify

Hong Kong Official Registry

60k+ structured register records — restaurants, clinics, lawyers, insurers, and more. Each profile page links to official JSON and a merged profile when enrichment exists.

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

Combines official register fields, claimed Agent Card (if any), and cited third-party enrichment. Returns dossierLayers, citationPolicy, trustBreakdown, and recommendedUse so agents know what is safe to cite.

Field Provenance

Layered dossier: official register (highest weight), owner-claimed structured fields, cited third-party sources with URL + fetchedAt, and proof-based reviews as auxiliary only. Trust Score is identity verification + official records + completeness + source consistency — not a black-box crawl score. Trusgent does not warehouse unauthorized open-web comments.

Live Places enrichment requires GOOGLE_PLACES_API_KEY; without it, demo enrichment is used. HK merchants fetch phone / hours / rating / Maps URL only (no bulk reviews), cached by place_id in registry_enrichment_snapshots — page and MCP reads never call Places live.

Default Integration Path (HK Registry)

Partner agents should treat get_merged_profile (or GET /api/v1/registry/{registryId}/merged) as the default read after search_registry. Use get_registry only when you need raw official fields without enrichment or claim context.

  1. search_registry — find candidates by name, address, or licence no.
  2. get_merged_profile — fetch official + claimed + enrichment with recommendedUse
  3. If claimed.trusgentId exists: verify_agent before recommending; optional get_business_facade
  4. Cite identity when recommendedUse.identity is safe_to_cite; treat hours/contact per recommendedUse

Example Merged Response

{
  "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"
  },
  "crossValidation": {
    "crossValidationCount": 2,
    "conflictStatus": "partial",
    "fields": [
      {
        "field": "name",
        "status": "match",
        "sources": [
          "official_registry",
          "enrichment"
        ]
      },
      {
        "field": "phone",
        "status": "conflict",
        "sources": [
          "official_registry",
          "enrichment"
        ]
      }
    ]
  },
  "fieldEvidence": {
    "official": {
      "name": {
        "value": "Good Day Cafe",
        "layer": "OFFICIAL_REGISTRY",
        "source": "FEHD",
        "sourceUrl": "https://www.fehd.gov.hk",
        "verifiedAt": "2026-08-24T00:00:00.000Z",
        "verificationLevel": "OFFICIAL",
        "method": "SYNC"
      }
    },
    "enrichment": {
      "hours": {
        "value": "Mon–Sun 11:00–23:00",
        "layer": "THIRD_PARTY_CITED",
        "source": "google_places",
        "verifiedAt": "2026-08-24T00:00:00.000Z",
        "verificationLevel": "INFERRED",
        "method": "google_places"
      }
    }
  }
}

Open Agent Card contract: docs/agent-card.md · MCP guide: docs/mcp.md · Quickstart Guide: docs/agent-trust-stack-quickstart.md