X402 Trust Scores

Name: X402 Trust Scores
Author: JonasFuchss

@JonasFuchss

Repository

About X402 Trust Scores

x402-trust gives AI agents a "check before you pay" layer for the x402 ecosystem.

#x402 #trust #score #compliance #endpoint

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "x402-trust": {
      "command": "npx",
      "args": [
        "-y",
        "x402-trust-mcp"
      ],
      "env": {
        "X402_TRUST_API_BASE": "https://x402.fuchss.app",
        "X402_PRIVATE_KEY": "0xYOUR_BASE_WALLET_KEY",
        "X402_MAX_USD": "0.05",
        "X402_MAX_TOTAL_USD": "1.00",
        "X402_MAX_CALLS": "1000",
        "X402_TIMEOUT_MS": "20000"
      }
    }
  }
}

Tools

Free aggregate snapshot of the entire x402 ecosystem (Base + Solana): how many endpoints are listed/active/delisted, what fraction are reachable and spec-compliant, and real on-chain USDC settlement volume / receivers / payers over the last 30 days. Use this to gauge market health before transacting.

Free top-25 most trustworthy x402 endpoints, ranked by a deterministic trust score (uptime, envelope compliance, latency, age, on-chain settlement activity, price stability). Use this to discover reliable paid endpoints.

FREE showcase of what x402_trust_score returns. You do NOT choose the endpoint: this returns the COMPLETE paid-grade trust report (every field — exact score, scoreRange, full component breakdown, advertised price, on-chain settlement figures, all flags) for THREE endpoints picked from the current population — the best-scored, the median, and the worst-scored ('samples' each carry 'role', 'populationRank', and the full 'report'). Use it to see exactly what the paid output looks like across the entire quality range BEFORE paying. It cannot score an endpoint you choose — to evaluate YOUR OWN endpoint, call x402_trust_score (paid). Takes no arguments.

Trust score (0-100, grade A-F) for a SPECIFIC x402 endpoint, PLUS a machine-readable verdict ('recommendation': proceed|caution|avoid), the advertised price ('advertised.amountUsd'), a confidence-adjusted band ('scoreRange'), and structured flags ('flagsDetailed' with code/severity/message — any severity 'error' means avoid). Includes the full component breakdown and 30-day on-chain stats. One call answers WHETHER and at WHAT PRICE to use an endpoint. Call this BEFORE paying an unknown x402 endpoint to avoid dead, fraudulent, or recently-hijacked services. Pay-per-call over x402; auto-pays if a wallet is configured, otherwise returns the price quote.

Raw observation time-series for a SPECIFIC x402 endpoint: listing/delisting/relisting events, advertised price changes, payTo changes, and probe results (uptime, latency, quoted amount) over the requested window (1-90 days). Pay-per-call over x402; auto-pays if a wallet is configured, otherwise returns the price quote.

Overview

What is X402 Trust Scores?

X402 Trust Scores is an MCP server that queries a continuously running service (https://x402.fuchss.app/) which probes every publicly listed x402 endpoint and scores each one from 0–100 (graded A–F) using real signals. It provides auditable, deterministic trust scores that catch issues that uptime-only checkers and raw explorers miss.

How to use X402 Trust Scores?

Configure the server to point to the service endpoint. The free tier returns ecosystem stats, a top-25 leaderboard, and a preview of the highest, lowest, and average scored endpoints. For per-endpoint trust scores and raw observation history, a Base USDC wallet must be configured to auto-pay per call over x402.

Key features of X402 Trust Scores

Scores based on uptime, compliance, latency, age, price stability, and on-chain settlement volume.
Every score is deterministic and fully auditable.
Includes a live probe at purchase time so "up" means right now.
Provides machine-readable flags and a clear verdict (proceed / caution / avoid).
Free tier offers ecosystem stats, top-25 leaderboard, and preview examples.

Use cases of X402 Trust Scores

Evaluate the trustworthiness of an x402 endpoint before using it.
Detect dead endpoints still showing cumulative transaction counts.
Identify endpoints with shared payTo addresses that obscure true settlement volume.
Spot malformed resource URLs or recently-changed payTo addresses.

FAQ from X402 Trust Scores

What signals does the trust score use?

The score combines 30-day uptime, 402-envelope spec compliance, latency, observed age, advertised-price stability, and actual on-chain USDC settlement volume to the endpoint’s payTo address.

Is there a free tier?

Yes. The free tier provides ecosystem stats, a top-25 trustworthy-endpoint leaderboard, and a preview example showing the highest, lowest, and average scored endpoints with all stats.

How do I get per-endpoint scores?

Per-endpoint trust scores and raw observation history require a paid (pay-per-call over x402) plan, which auto-pays if a Base USDC wallet is configured.

Where can I see the full list of endpoints?

All endpoints are also listed on x402scan.com. Search for "x402.fuchss.app" on that site.

What does the live probe do?

The service performs a live probe at purchase time so that an "up" status means the endpoint is actually reachable at that moment, not just historically.