MCP tools for checking vet402 trust scores from Claude Desktop, Cursor, or any MCP client — so an agent can ask "is this wallet safe to pay?" before it pays.

Published on npm. No clone, no build: your MCP client launches it with npx.

npm install -g @vouchscore/mcp-server   # optional — the configs below use npx

Tools

Tool	Description
`check_agent_trust`	Score by agent ID (optional wallet verification)
`check_wallet_trust`	Score by wallet (x402 payer path)
`check_payee_trust`	Buyer-side: score a payment recipient before paying it (score + dataDepth + recommendation)
`explain_trust_score`	Human-readable score breakdown (includes x402 + dataCoverage)
`attest_x402_payment`	Write settlement attestation after payment verification

Setup — Claude Desktop

Get a key at vet402.com/dashboard/keys, then add this to ~/Library/Application Support/Claude/claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json on Windows) and restart the app:

{
  "mcpServers": {
    "vouch": {
      "command": "npx",
      "args": ["-y", "@vouchscore/mcp-server"],
      "env": {
        "VOUCH_API_URL": "https://vet402.com/api/v1",
        "VOUCH_API_KEY": "vouch_live_your_key_here"
      }
    }
  }
}

Setup — Cursor

Same block in ~/.cursor/mcp.json (or a project-local .cursor/mcp.json):

{
  "mcpServers": {
    "vouch": {
      "command": "npx",
      "args": ["-y", "@vouchscore/mcp-server"],
      "env": {
        "VOUCH_API_URL": "https://vet402.com/api/v1",
        "VOUCH_API_KEY": "vouch_live_your_key_here"
      }
    }
  }
}

Confirm it starts before wiring it into a client:

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"1"}}}' \
  | VOUCH_API_KEY=vouch_live_your_key_here npx -y @vouchscore/mcp-server

A serverInfo line comes back on stdout. The package also installs a vouch-mcp binary, if you prefer npx -p @vouchscore/mcp-server vouch-mcp.

Environment

Variable	Default	Description
`VOUCH_API_KEY`	—	Required. Create one here.
`VOUCH_API_URL`	`https://vet402.com/api/v1`	API base URL. Override only to point at another deployment.

0.1.0 defaults VOUCH_API_URL to http://localhost:3000/api/v1 — a development default that shipped by accident. The configs above set it explicitly, so they are correct on every version; 0.1.1 and later default to the hosted API.

Example prompts

"Check trust for agent 42 on Base"
"Is wallet 0xabc... safe to accept x402 payment from?"
"Is it safe to pay wallet 0xdef...? Check its payee trust first"
"Explain the trust score for agent 7"

Building from the repo (contributors)

git clone https://github.com/kzmttkc/agent-trust.git
cd agent-trust/packages/mcp-server && npm install && npm run build
# then point your client at "command": "node", "args": ["<abs>/dist/index.js"]