X402 Trust MCP
Search x402 endpoints and check their trust score before your agent pays
- 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-mcpAdd 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

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government