# X402 Trust MCP

> X402 Trust MCP is a freemium MCP server for finance and payments. Search x402 endpoints and check their trust score before your agent pays. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://x402-trust.com
- **Repository:** https://github.com/jonasfuchss/x402-trust-mcp
- **MCP Registry name:** io.github.JonasFuchss/x402-trust-mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/x402-trust-mcp
