Trusgent MCP

Official10 toolsLive

by Trusgent

Trusgent MCP — Trust Layer for AI agents. HK registry + Agent Cards. Default: get_merged_profile.

Trusgent MCP (io.github.Trusgent/trusgent-mcp)

Trusgent MCP is an MCP server described as a “Trust Layer for AI agents.” It provides a Hong Kong official registry for verified Agent Cards and citation-safe merged profiles for MCP clients. Its default behavior is get_merged_profile.

🛠️ Key Features

Verified Agent Cards
Hong Kong official registry
Citation-safe merged profiles for MCP clients
Default tool: get_merged_profile
10 total tools

🚀 Use Cases

Use MCP clients to retrieve citation-safe merged profiles for agent-related information
Rely on the Hong Kong registry when working with verified Agent Cards

⚡ Developer Benefits

Standard MCP access to get_merged_profile
Consistent, registry-backed merged profile data for MCP clients

⚠️ Limitations

Available documentation excerpt does not enumerate all 10 tools or their specific inputs/outputs

Topics

agentagentic-aillmmcptrusgent

Captured live from the server via tools/list.

search_agents

Search the Trusgent Trust Layer directory for people and businesses with public Agent Cards. Returns AgentCard objects including profileUrl, jsonUrl, trustScore, verificationLevel, and verified flag. Use before recommending any agent to an end user.

Parameters6

q	string	optional	Free-text query (name, headline, keyword)
country	string	optional	ISO country code, e.g. CN, HK
type	string	optional	PERSONAL \| COMPANY \| ORGANIZATION \| SERVICE_PROVIDER \| PRODUCT \| AI_AGENT
verificationLevel	string	optional	Optional verification level filter
agentReady	string	optional	true \| false — filter agent-ready cards
sort	string	optional	Optional sort key supported by the directory search API

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free-text query (name, headline, keyword)"
    },
    "country": {
      "type": "string",
      "description": "ISO country code, e.g. CN, HK"
    },
    "type": {
      "type": "string",
      "description": "PERSONAL | COMPANY | ORGANIZATION | SERVICE_PROVIDER | PRODUCT | AI_AGENT"
    },
    "verificationLevel": {
      "type": "string",
      "description": "Optional verification level filter"
    },
    "agentReady": {
      "type": "string",
      "description": "true | false — filter agent-ready cards"
    },
    "sort": {
      "type": "string",
      "description": "Optional sort key supported by the directory search API"
    }
  }
}

get_agent

Fetch one full Agent Card by public trusgentId (same ID used in /t/{id} and /b/{id}). Returns structured profile fields, trustScore, verification, and canonical URLs for humans and machines.

Parameters1

trusgentId

string

required

Public AgentID, e.g. TG-S-839201

Raw schema

{
  "type": "object",
  "properties": {
    "trusgentId": {
      "type": "string",
      "description": "Public AgentID, e.g. TG-S-839201"
    }
  },
  "required": [
    "trusgentId"
  ]
}

verify_agent

Lightweight verification lookup: whether an AgentID exists, is public, and its verification level / trustScore. Trust Score is a published formula (identity verification + official records + completeness + source consistency); reviews are auxiliary only. Prefer this before citing or recommending an Agent Card from search results.

Parameters1

trusgentId

string

required

Public AgentID to verify

Raw schema

{
  "type": "object",
  "properties": {
    "trusgentId": {
      "type": "string",
      "description": "Public AgentID to verify"
    }
  },
  "required": [
    "trusgentId"
  ]
}

get_business_facade

Fetch a published business facade (menu/services, hours, booking capabilities) by the same public ID/handle as /b/{id}. Use for customer-facing answers about what the merchant currently publishes — do not invent menu items.

Parameters1

handle

string

required

Public ID / facade handle

Raw schema

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "Public ID / facade handle"
    }
  },
  "required": [
    "handle"
  ]
}

check_availability

Check remaining reservation capacity for a business facade slot before create_reservation. HTTP equivalent: GET /api/v1/b/{handle}/availability?date=YYYY-MM-DD&time=HH:mm.

Parameters3

handle	string	required	Public facade handle (AgentID)
date	string	required	Reservation date (YYYY-MM-DD)
time	string	required	Reservation time (HH:mm)

Raw schema

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "Public facade handle (AgentID)"
    },
    "date": {
      "type": "string",
      "description": "Reservation date (YYYY-MM-DD)"
    },
    "time": {
      "type": "string",
      "description": "Reservation time (HH:mm)"
    }
  },
  "required": [
    "handle",
    "date",
    "time"
  ]
}

create_reservation

Submit a booking or appointment request for a published business facade. Creates a PENDING reservation; the merchant confirms in Dashboard. Not a guaranteed instant booking. HTTP equivalent: POST /api/v1/b/{handle}/reservations.

Parameters11

handle	string	required	Public facade handle (AgentID)
mode	string	optional	table for dine-in; appointment for generic services
name	string	required	Guest name
phone	string	required	Guest phone (E.164 or local)
email	string	optional	Optional guest email
partySize	integer	required	Party size (1–40)
date	string	required	YYYY-MM-DD
time	string	required	HH:mm
note	string	optional	Optional note for the merchant
table	string	optional	Optional table code from facade.tables
service	string	optional	Optional service label

Raw schema

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "Public facade handle (AgentID)"
    },
    "mode": {
      "type": "string",
      "enum": [
        "table",
        "appointment"
      ],
      "description": "table for dine-in; appointment for generic services"
    },
    "name": {
      "type": "string",
      "description": "Guest name"
    },
    "phone": {
      "type": "string",
      "description": "Guest phone (E.164 or local)"
    },
    "email": {
      "type": "string",
      "description": "Optional guest email"
    },
    "partySize": {
      "type": "integer",
      "description": "Party size (1–40)"
    },
    "date": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "time": {
      "type": "string",
      "description": "HH:mm"
    },
    "note": {
      "type": "string",
      "description": "Optional note for the merchant"
    },
    "table": {
      "type": "string",
      "description": "Optional table code from facade.tables"
    },
    "service": {
      "type": "string",
      "description": "Optional service label"
    }
  },
  "required": [
    "handle",
    "name",
    "phone",
    "partySize",
    "date",
    "time"
  ]
}

create_order

Submit a dine-in or takeaway order from a published restaurant facade menu. Creates a PENDING order; kitchen confirms in Dashboard. Restaurant facades only; menu item names must match facade.menu. HTTP equivalent: POST /api/v1/b/{handle}/orders.

Parameters7

handle	string	required	Public facade handle (AgentID)
table	string	required	Table code from facade.tables, or TAKEAWAY / PICKUP for off-premise
fulfillmentMode	string	optional	Defaults to DINE_IN
guestName	string	optional	Guest name (required for takeaway/pickup)
guestPhone	string	optional	Guest phone (required for takeaway/pickup)
note	string	optional	Optional note for the kitchen
items	array	required	Menu lines — names must match published facade menu

Raw schema

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "Public facade handle (AgentID)"
    },
    "table": {
      "type": "string",
      "description": "Table code from facade.tables, or TAKEAWAY / PICKUP for off-premise"
    },
    "fulfillmentMode": {
      "type": "string",
      "enum": [
        "DINE_IN",
        "TAKEAWAY",
        "PICKUP"
      ],
      "description": "Defaults to DINE_IN"
    },
    "guestName": {
      "type": "string",
      "description": "Guest name (required for takeaway/pickup)"
    },
    "guestPhone": {
      "type": "string",
      "description": "Guest phone (required for takeaway/pickup)"
    },
    "note": {
      "type": "string",
      "description": "Optional note for the kitchen"
    },
    "items": {
      "type": "array",
      "description": "Menu lines — names must match published facade menu",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "qty": {
            "type": "integer",
            "minimum": 1,
            "maximum": 40
          },
          "price": {
            "type": "string",
            "description": "Optional display price echo from menu"
          },
          "currency": {
            "type": "string",
            "description": "Optional currency echo from menu"
          }
        },
        "required": [
          "name",
          "qty"
        ]
      }
    }
  },
  "required": [
    "handle",
    "table",
    "items"
  ]
}

get_registry

Fetch one official Hong Kong registry record by registryId (e.g. fehd-3715038328). Returns official fields plus provenance and verify links. Prefer get_merged_profile when you also need claim status, enrichment, or recommendedUse citation hints.

Parameters1

registryId

string

required

Public registry handle, e.g. fehd-3715038328

Raw schema

{
  "type": "object",
  "properties": {
    "registryId": {
      "type": "string",
      "description": "Public registry handle, e.g. fehd-3715038328"
    }
  },
  "required": [
    "registryId"
  ]
}

search_registry

Search Hong Kong official registry records (~60k+) by name, address, licence number, or registryId. Optional source filter (FEHD_RESTAURANT, EHEALTH_HCP, etc.). Returns lightweight rows with profileUrl and mergedUrl; follow up with get_merged_profile for citation-safe detail.

Parameters4

q	string	optional	Free-text query
source	string	optional	Registry source enum, optional
country	string	optional	ISO country code, e.g. HK
limit	number	optional	Max results (default 25, max 50)

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free-text query"
    },
    "source": {
      "type": "string",
      "description": "Registry source enum, optional"
    },
    "country": {
      "type": "string",
      "description": "ISO country code, e.g. HK"
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 25, max 50)"
    }
  }
}

get_merged_profile

Preferred HK registry read: official registry fields merged with claimed Agent Card data and cited third-party enrichment (Google Places POC when available). Includes dossierLayers, citationPolicy, trustBreakdown, and recommendedUse so agents know what is safe to cite. Reviews are auxiliary and are not scraped from the open web.

Parameters2

registryId	string	required	Public registry handle, e.g. fehd-3715038328
locale	string	optional	en \| zh-CN \| zh-HK

Raw schema

{
  "type": "object",
  "properties": {
    "registryId": {
      "type": "string",
      "description": "Public registry handle, e.g. fehd-3715038328"
    },
    "locale": {
      "type": "string",
      "description": "en | zh-CN | zh-HK"
    }
  },
  "required": [
    "registryId"
  ]
}

README.md4 KBView on GitHub

Trusgent MCP

Trust Layer for AI agents — verified Agent Cards, Hong Kong official registry, and citation-safe merged profiles for MCP clients.

English · 简体中文 · Developer Docs · Integration Guide · Smithery · Claude Market

🔐 Trust Layer for AI agents

✅ Verified Agent Cards

🇭🇰 60k+ HK official registry

🧩 Merged profiles with citation-safe recommendedUse

🌐 Remote endpoint: https://www.trusgent.com/api/mcp

Built for agents that need trustworthy business data — not scraped guesswork.

Public manifest and partner docs for Trusgent MCP — the Trust Layer remote MCP server for AI agents.

Note: The Trusgent product application (website, dashboard, registry importers) is private. This repository is intentionally public — it contains only the MCP Registry manifest, directory submission copy, and links to hosted APIs at trusgent.com. No secrets belong in this repo — see SECURITY.md.

MCP Endpoint


URL	`https://www.trusgent.com/api/mcp`
Transport	Streamable HTTP (JSON-RPC POST)
Discovery	`GET https://www.trusgent.com/api/mcp`
Auth	Optional `Authorization: Bearer <api_key>` — create a key. Public reads are IP rate-limited without a key.

Default Integration Flow (Hong Kong Registry)

code

search_registry → get_merged_profile → (if claimed) verify_agent → (optional) get_business_facade

Use get_registry only when you need raw official fields without enrichment or claim context.

Tools

Agent Cards: search_agents, get_agent, verify_agent, get_business_facade
HK official registry: search_registry, get_registry, get_merged_profile (preferred)

Documentation

Official MCP Registry

Field	Value
Product Name	Trusgent MCP
Registry Name	`io.github.Trusgent/trusgent-mcp`
Manifest	`server.json`

Publish

Prerequisites: GitHub org member with permission to publish under Trusgent (io.github.Trusgent/*).

Recommended: GitHub Actions OIDC from this repo (Actions → Publish to MCP Registry → Run workflow). Local mcp-publisher login github may only grant io.github.peteyhuang/* unless the OAuth token includes org Owner scope.

bash

mcp-publisher validate server.json
mcp-publisher login github
mcp-publisher publish server.json

Directory Submissions

Platform	Copy
Smithery	`smithery-submission.md`
Claude Market	`claude-market-submission.md`

Client Config Example

json

{
  "mcpServers": {
    "trusgent-mcp": {
      "url": "https://www.trusgent.com/api/mcp"
    }
  }
}

Organization

All Trusgent public open-source projects: github.com/Trusgent

Install

Tools (10)

search_agentsget_agentverify_agentget_business_facadecheck_availabilitycreate_reservationcreate_orderget_registry

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://www.trusgent.com/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "trusgent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.trusgent.com/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Trusgent MCP (io.github.Trusgent/trusgent-mcp)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

search_agents

get_agent

verify_agent

get_business_facade

check_availability

create_reservation

create_order

get_registry

search_registry

get_merged_profile

Trusgent MCP

MCP Endpoint

Default Integration Flow (Hong Kong Registry)

Tools

Documentation

Official MCP Registry

Publish

Directory Submissions

Client Config Example

Organization

Install

Remote endpoint

Related servers