Skip to content
MCP server

X402score MCP

Check an x402-paid API endpoint's trust score and grade before an agent pays it

Runs locally
Install
Platforms
CLI, API
Runs
Locally
GitHub stars
0
Last commit
1 month ago
Language
TypeScript
Version
0.4.2

Similar MCP servers

About X402score MCP

X402score MCP is an MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

x402 lets an agent pay for an API call directly, which raises the question of whether an endpoint is worth paying. This server queries x402Score's reputation data so an agent can look up a score, grade and credible interval for an endpoint first. The registry description stresses that the data comes from live probing rather than self-reporting.

Beyond single lookups, an agent can search the leaderboard by name, domain, vertical or id and sort by score, price, uptime or latency, check whether the scoring formula is actually predictive through a calibration report, queue a new endpoint for monitoring, or ping the backend. A methodology resource explains what the score, grade, credible interval and on-chain modifier mean.

All tools carry read-only and idempotency annotations with output schemas and return structured errors, including backend rate-limit text, and requests time out client-side after 10 seconds. At the time of the README, the package was on npm but its registry listing was being held until an on-chain calibration gate closed.

Install

Run in a terminal

claude mcp add x402score-mcp -- npx -y x402score-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "x402score-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "x402score-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "x402score-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "x402score-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "x402score-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "x402score-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "x402score-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "x402score-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "x402score-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "x402score-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (5)

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

check_endpoint_score
Score, grade and credible interval for one endpoint
search_leaderboard
Search tracked endpoints by name, domain, url, id or vertical
get_calibration_report
Report on whether the scoring formula is predictive
submit_endpoint
Add an x402 endpoint to the monitoring queue
ping
Reachability and latency check

What it does

Endpoint scoring
Returns a score, grade and credible interval for one URL.
Leaderboard search
Browse tracked endpoints sorted by score, price, uptime or latency.
Calibration report
Shows whether the scoring formula predicts outcomes.
Submit endpoints
Queue a new x402 endpoint for monitoring.
Methodology resource
Explains the score, grade and modifier.
Fast failure
Structured errors and a 10-second timeout instead of hanging.

Good for

  • Vet a paid API before an agent spends on it
  • Find the cheapest or most reliable endpoint in a vertical
  • Check whether a scoring system is calibrated
  • Add an unlisted endpoint to be monitored

Pricing

Pricing unknown

Pricing not published

X402score MCP FAQ

How do I install it?

Run npx -y x402score-mcp as a stdio command in your MCP config.

Can I point it at my own backend?

Yes, set X402SCORE_BASE_URL, but the README warns to use only a backend you trust.

Does it make payments?

No, it only reads reputation data and can submit endpoints for monitoring.

Is it in an MCP registry?

The README says the registry listing was being held back at the time it was written.

How do I add X402score MCP to Claude Code?

Run this command in your terminal: claude mcp add x402score-mcp -- npx -y x402score-mcp

What are the best alternatives to X402score MCP?

The closest alternatives to X402score MCP are X402 Trust MCP, x402 Router, X402 List MCP, x402 Cartographer and MoneyTools x402 Status & MCP Check.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers