TrustBench MCP Server

x402 provider rankings + Ed25519-signed payment receipts + signature verification (3 tools).

Local serverstdioTypeScript

What is the TrustBench MCP server?

Most payments and commerce work still happens through a UI a human drives. TrustBench MCP server moves it into the conversation instead. x402 provider rankings + Ed25519-signed payment receipts + signature verification (3 tools).

The short version

Verify that x402 payments settled on-chain and get cryptographically signed proof. POST /verify with a receipt ID or raw envelope to confirm Ed25519 signature validity + on-chain settlement on Base, no trust required.

The tools it exposes

The server publishes 9 tools. What each one is for:

  • Ed25519 — signed scorecards, public key at /.well-known/trustbench-pubkey
  • x402 — paywalled API endpoints (per-call USDC pricing surface)
  • get_rankings — scored providers by capability. No API key
  • get_receipt — fetch any receipt by ID (rcpt_… / rrcpt_…). No API key
  • verify_receipt — confirm Ed25519 signature + on-chain status. No API key
  • Server — enforced spend caps (the agent must enforce caps locally if it cares)
  • Per-paying — wallet hourly rate limit.** Default 60 paid calls per hour per agent_address. Tunable via TRUSTBENCH_PAYWALL_HOURLY_LIMIT (set to 0 to disable)
  • Idempotency — key replay with replayed_at marker.** Idempotency-Key header (16-128 chars) honored on every paywalled call. Same key + same body within 24 hours
  • Single — merchant routing.** POST /route serves one capability against one selected provider per call. Multi-merchant fan-out (one intent → multiple paid APIs

Getting it running

The server ships on npm as @trustbench/verify-receipt, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

How it compares

This sits in the payments and commerce group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. TrustBench's toolset — Ed25519, x402, get_rankings and 6 more — is a fair guide to whether it matches your workflow.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 9 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch TrustBench.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
Ed25519signed scorecards, public key at /.well-known/trustbench-pubkey
x402paywalled API endpoints (per-call USDC pricing surface)
get_rankingsscored providers by capability. No API key.
get_receiptfetch any receipt by ID (rcpt_… / rrcpt_…). No API key.
verify_receiptconfirm Ed25519 signature + on-chain status. No API key.
Serverenforced spend caps (the agent must enforce caps locally if it cares).
Per-payingwallet hourly rate limit.** Default 60 paid calls per hour per agent_address. Tunable via TRUSTBENCH_PAYWALL_HOURLY_LIMIT (set to 0 to disable). Returns 429 with Retry-After: 60 when exceeded.
Idempotencykey replay with replayed_at marker.** Idempotency-Key header (16-128 chars) honored on every paywalled call. Same key + same body within 24 hours returns the original signed receipt with a top-level replayed_at field add
Singlemerchant routing.** POST /route serves one capability against one selected provider per call. Multi-merchant fan-out (one intent → multiple paid APIs → one envelope) is Phase 4.

How to install the TrustBench MCP server

{
  "mcpServers": {
    "trustbench": {
      "command": "npx",
      "args": ["-y", "@trustbench/mcp"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

  • Use TrustBench to Ed25519.
  • Use TrustBench to x402.
  • Use TrustBench to get rankings.

Frequently asked questions

It connects TrustBench to MCP-compatible AI assistants such as Claude and Cursor, exposing 9 tools (Ed25519, x402, get_rankings, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with TrustBench directly.