Agent Trust Oracle MCP
Wire the Agent Trust Oracle into Claude Desktop, Cursor, or any MCP
client as tools. Ask your agent for an ERC-8004 trust score and it calls the
tool; for the paid tool the bridge pays USDC on Base automatically via
x402 and returns the signed result.
The get_trust_preview tool is free and needs no wallet key. The paid
tool costs a few cents per call and activates only when you set a Base wallet key.
Quick start (no clone, no build)
Add this to your client config and you're done — npx fetches and runs it:
Claude Desktop — Settings → Developer → Edit Config:
{
"mcpServers": {
"agent-trust": {
"command": "npx",
"args": ["-y", "@nikosble1926/agent-trust-mcp"]
}
}
}
That gives you the free preview out of the box. To enable the paid tool,
add a low-balance Base wallet key:
{
"mcpServers": {
"agent-trust": {
"command": "npx",
"args": ["-y", "@nikosble1926/agent-trust-mcp"],
"env": {
"EVM_PRIVATE_KEY": "0x<your-low-balance-base-wallet-private-key>"
}
}
}
}
Cursor — Settings → MCP → Add new server, same command/args/env.
Restart the client, then ask: "Get an agent trust preview" (free) or
"Get the trust score for agent 6976 on ethereum" (paid).
| Tool | Cost | Description |
|---|
get_trust_preview | free | Example ERC-8004 agent trust score (0–100) with component breakdown, no wallet key required |
get_agent_trust | $0.005 USDC | Signed ERC-8004 trust score (0–100) + component breakdown (client breadth, recency, value, volume) for one agent. Params: agent (uint256 id, e.g. 6976), chain (base/bsc/ethereum/mantle/polygon, default ethereum) |
Paid mode (optional)
The paid tool needs an EVM_PRIVATE_KEY: a Base wallet private key for a
low-balance, dedicated hot wallet holding a little USDC — never your main
wallet. Payments are gasless for the payer (the facilitator covers gas), so you
mainly need a small USDC balance. Without the key, the paid tool returns a clear
"set EVM_PRIVATE_KEY" message and the free preview keeps working.
RESOURCE_SERVER_URL is optional and defaults to https://trust.nsgoods.org.
Run from source (dev)
cd mcp
npm install
npm run build
node dist/server.js
Security
- The
EVM_PRIVATE_KEY is yours (the buyer's) and stays local in your
client config — it is never sent to the API. Use a throwaway hot wallet with
only a small USDC balance.
- For spend control, see the policy-check hooks in the
official x402 MCP guide
and cap per-call / per-session amounts.
Notes
Mirrors the official x402 MCP client pattern:
https://docs.x402.org/guides/mcp-server-with-x402 . The x402 v2 TypeScript
packages (@x402/axios, @x402/evm) evolve quickly — if npm install or the
build fails, check that guide for current package names/versions.
Trust scores read on-chain ERC-8004 Identity + Reputation registries; every paid
/agent-trust and free /agent-trust/preview response carries signed_by +
signature for verification. No accounts, no API keys on the service side.
Educational — not financial advice. MIT licensed.