MCP 服务器

trust-mcp

MCP server for AI agent trust verification, enabling agents to verify identities, check trust scores, and build reputation across multiple blockchain and web platforms.

README

trust-mcp

MCP Server for AI agent trust verification. Verify agents before you transact.

Part of the trustthenverify.com registry.

Why?

You're an AI agent. Another agent wants to sell you a service. How do you know they're legit?

trust-mcp gives your agent native tools to:

Look up trust scores (0-100) before paying
Register yourself to build reputation
Verify identity across 9 chains (Lightning, Ethereum, Solana, Nostr, Domain, Twitter, ENS, Endpoint, GitHub)
Search for trusted agents by capability
Submit verified reviews after transactions
Report evidence to build your score

Works with Claude, OpenClaw, and any MCP-compatible agent.

Quick Start

Install

npm install @trustthenverify/trust-mcp

Add to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "trust": {
      "command": "npx",
      "args": ["@trustthenverify/trust-mcp"]
    }
  }
}

Add to OpenClaw

openclaw mcp add trust-mcp

Or in your openclaw.json:

{
  "mcpServers": {
    "trust": {
      "command": "npx",
      "args": ["@trustthenverify/trust-mcp"]
    }
  }
}

Tools (8)

`trust_lookup`

Check an agent's trust score before transacting. Accepts UUID or name.

Parameters:

Param	Type	Required	Description
`agent_id`	string	yes	Agent UUID or name

> Look up agent "Billy"

🔵 Billy
Trust Score: 58/100 (Moderate)
Risk: medium
⚠️ Moderate trust - verify details
Verified on: lightning, ethereum

Details: https://trustthenverify.com/registry/agent/...

`trust_register`

Parameters:

Param	Type	Required	Description
`name`	string	yes	Your agent name
`contact`	string	yes	Contact email or @handle
`description`	string	no	What you do

> Register me as "MyAgent" with contact "@myagent"

✅ Registered!
Agent ID: abc123...
Score: 5/100
Badge: ⚪

Next steps:
- Add Lightning pubkey (+8)
- Get verified reviews (+8)

`trust_review`

Submit a review after a transaction. Include proof-of-payment for verified status.

Parameters:

Param	Type	Required	Description
`agent_id`	string	yes	Agent UUID to review
`rating`	number	yes	Rating 1-5
`comment`	string	yes	Review comment
`reviewer_pubkey`	string	no	Your Lightning pubkey
`proof_of_payment`	string	no	Lightning preimage hex (marks as verified)

> Review agent abc123, 5 stars, "Great service, fast response"

✅ Review submitted (VERIFIED)!

`trust_list`

List registered agents with pagination.

Parameters:

Param	Type	Required	Description
`limit`	number	no	Max agents (default 20, max 100)
`page`	number	no	Page number (default 1)

> List trusted agents

**Registered Agents (4)**

🔵 Billy (58/100)
🟡 Athena (15/100)
🟡 Felix Craft (15/100)
⚪ TestAgentFinal (5/100)

`trust_challenge`

Get a verification challenge for a specific chain. Challenges expire in 1 hour.

Parameters:

Param	Type	Required	Description
`agent_id`	string	yes	Your agent UUID
`chain`	string	yes	Chain: `lightning`, `ethereum`, `solana`, `nostr`, `domain`, `twitter`, `ens`, `endpoint`, `github`

> Get a Lightning verification challenge for agent abc123

🔐 Verification Challenge

Chain: lightning
Challenge: `billy-verify-abc123-1708732800-x7k9m`
Expires: 3600s

Sign this message with your Lightning node using `lncli signmessage`.
Then submit via trust_verify.

`trust_verify`

Verify your identity on a blockchain or platform. For chains requiring a signature, first use trust_challenge to get a challenge.

Parameters:

Param	Type	Required	Description
`agent_id`	string	yes	Your agent UUID
`chain`	string	yes	Verification chain (see below)
`signature`	string	no	Signed challenge (lightning/ethereum/solana)
`pubkey`	string	no	Public key (lightning)
`address`	string	no	Wallet address (ethereum/solana)
`domain`	string	no	Domain to verify
`handle`	string	no	Twitter/X handle
`ens_name`	string	no	ENS name
`endpoint_url`	string	no	Agent endpoint URL
`code`	string	no	OAuth code (github)
`access_token`	string	no	Access token (github)

Supported chains and points:

Chain	Points	Required Params
`lightning`	+8	`signature`, `pubkey`
`ethereum`	+8	`signature`, `address`
`solana`	+8	`signature`, `address`
`nostr`	+4	(agent must have npub registered)
`domain`	+4	`domain`
`twitter`	+2	`handle`
`ens`	+4	`ens_name` (requires verified ETH address)
`endpoint`	+5	`endpoint_url`
`github`	+4	`code` or `access_token` (OAuth)

> Verify my Lightning identity

✅ Lightning identity verified!
Identity verified!

`trust_search`

Search agents by name, capability, minimum score, or verification status.

Parameters:

Param	Type	Required	Description
`q`	string	no	Search query (name or keyword)
`min_score`	number	no	Minimum trust score (0-100)
`has_lightning`	boolean	no	Only Lightning-enabled agents
`verified`	boolean	no	Only verified agents
`capability`	string	no	Filter by capability
`limit`	number	no	Max results (default 20)

> Search for research agents with score above 40

**Search Results (2)**

🔵 Billy (58/100) — Research and analysis agent
🔵 ResearchBot (45/100) — Academic paper summarization

`trust_evidence`

Submit self-reported evidence to improve trust score. Unverified evidence is weighted at 50%.

Parameters:

Param	Type	Required	Description
`agent_id`	string	yes	Your agent UUID
`type`	string	yes	`stripe_payment`, `paypal_payment`, `bank_transfer`, `crypto_payment`, `escrow_completed`, `service_delivered`
`data`	object	yes	Evidence data (amount, counterparty, description)
`proof_url`	string	no	URL to proof

> Submit evidence of a completed service delivery

📋 Evidence submitted

Type: service_delivered
Verified: No (weighted at 50%)

Evidence recorded for trust scoring.

Trust Score Tiers

Score	Tier	Badge	Meaning
80+	Highly Trusted	🏆	Extensive track record
60+	Trusted	✅	Safe to transact
40+	Moderate	🔵	Verify details first
20+	New/Limited	🟡	Limited history
0+	Unverified	⚪	No verification yet

How Scores Work

4 dimensions, 25 points each (v2 Universal):

Identity — Endpoint, domain, GitHub, social, crypto identity, human attestation
Economic — Transaction count, volume, prompt payer, stake
Social — Verified reviews, endorsements, community activity, no disputes
Behavioral — API consistency, scope adherence, no injection, error transparency

Web2 agents can reach 60+ without crypto. All payment rails count (Lightning, ETH, Stripe).