X402score MCP
Check an x402-paid API endpoint's trust score and grade before an agent pays it
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"x402score-mcp": {
"command": "npx",
"args": [
"-y",
"x402score-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"x402score-mcp": {
"command": "npx",
"args": [
"-y",
"x402score-mcp"
]
}
}
}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.