Skip to content
MCP server

X402 Trust MCP

Search x402 endpoints and check their trust score before your agent pays

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally
Version
1.16.0
Listing updated
2 days ago

About X402 Trust MCP

X402 Trust MCP is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

x402 lets agents pay for API calls in USDC. This server sits in front of that spending: it searches a catalogue the site puts at more than 400,000 endpoints and returns a trust verdict for any of them before a payment goes out. Scores come from round-the-clock uptime probes, 402-envelope spec checks, price history and measured on-chain settlement on Base and Solana, computed deterministically with no LLM involved.

Fifteen tools are exposed, nine free and six paid per call. Free ones cover ecosystem stats, a top-100 leaderboard, verified providers, keyword and semantic search and a trust preview. Paid ones cost from $0.005 for a single score to about $0.50 for a 500-endpoint bulk run, and include watches that alert on price or payee changes and downtime.

Without a wallet key the paid tools return a price quote. With X402_PRIVATE_KEY set to a funded Base wallet, the server pays automatically within caps on per-call spend, total spend and call count. A hosted POST /mcp endpoint offers the same tools without installing anything.

Install

Run in a terminal

claude mcp add x402-trust-mcp --env X402_PRIVATE_KEY='<X402_PRIVATE_KEY>' -- npx -y x402-trust-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "x402-trust-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "x402-trust-mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "x402-trust-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "x402-trust-mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "x402-trust-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "x402-trust-mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "x402-trust-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "x402-trust-mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "x402-trust-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "x402-trust-mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
      }
    }
  }
}

Configuration

  • X402_PRIVATE_KEYOptional Base wallet private key (with or without the 0x prefix). When set, the paid tools auto-pay over x402 up to X402_MAX_USD; otherwise they return a price quote. The free tools need no key.
  • X402_MAX_USDPer-call auto-pay ceiling in USD. 0 disables auto-pay.
  • X402_MAX_TOTAL_USDCumulative auto-pay cap per process in USD. 0 = unlimited.
  • X402_MAX_CALLSMax paid calls per process. 0 = unlimited.
  • X402_TRUST_API_BASEAPI base URL.
  • X402_TIMEOUT_MSRequest timeout in milliseconds.

Tools this server provides (15)

Taken from the project documentation; the running server may differ.

x402_ecosystem_stats
Snapshot of endpoint counts, reachability and USDC volume
x402_trust_leaderboard
Top-100 ranking of trusted x402 hosts
x402_verified_providers
Hosts that proved domain control
x402_search
Substring search over host, URL and service name
x402_semantic_search
Meaning-based search
x402_trust_preview
Three complete sample trust reports
x402_trust_score
Full trust verdict for one endpoint
x402_endpoint_history
Probe and event history over 1-90 days
x402_find_alternatives
Similar endpoints that out-score a given one
x402_trust_bulk
Score up to 500 endpoints in one call
x402_watch_create
30-day monitor for one endpoint
x402_watch_events
Poll a watch's event log
x402_watch_edit
Change a watch's webhooks or sensitivity
x402_watch_cancel
Stop a watch
x402_watch_renew
Add 30 days to a watch

What it does

Keyword and semantic search
Find endpoints by host, name or URL, or describe the capability in plain words.
Trust scores
A 0-100 score, grade, recommendation, price and flags for one endpoint; unknown ones are probed live.
Bulk scoring
Score up to 500 endpoints in one call, with the cheapest fitting tier chosen automatically.
Endpoint watches
30-day monitors alert on payTo or price changes, delisting, spec regressions and downtime.
Spending caps
Environment variables limit per-call, cumulative and call-count auto-pay.
Free ecosystem data
Leaderboard, stats, verified providers and a trust preview cost nothing.

Good for

  • Vet an x402 endpoint before an agent pays it
  • Find a cheaper or better-scoring alternative to a given endpoint
  • Monitor a paid dependency for price or payee changes
  • Rank many candidate endpoints in one bulk call

Pricing

Freemium

Free tools; paid tools from $0.005 per call over x402

Prices change. Check x402-trust.com before you buy.

X402 Trust MCP FAQ

Do I need a wallet?

Not for the free tools. Paid tools return a price quote unless X402_PRIVATE_KEY is set to a Base wallet key.

What does it cost?

Paid calls range from $0.005 for a single score to about $0.50 for a 500-endpoint bulk score, charged in USDC on Base.

How can I limit spending?

X402_MAX_USD defaults to 0.05 per call, X402_MAX_TOTAL_USD to 1.00 per process and X402_MAX_CALLS to 1000.

Is there a hosted version?

Yes. A hosted endpoint at POST /mcp offers the same tools with no install.

Is X402 Trust MCP free?

X402 Trust MCP has a free plan, with paid plans for more usage or features.

How do I add X402 Trust MCP to Claude Code?

Run this command in your terminal: claude mcp add x402-trust-mcp --env X402_PRIVATE_KEY='<X402_PRIVATE_KEY>' -- npx -y x402-trust-mcp

What are the best alternatives to X402 Trust MCP?

The closest alternatives to X402 Trust MCP are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

Alternatives to X402 Trust MCP

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government