x402lint
Lint the unpaid 402 challenge of an x402 payment endpoint before you list it
- Pricing
- Open source
- Platforms
- API, Web
- Runs
- Remotely
- Version
- 0.2.0
- Listing updated
- 2 days ago
About x402lint
x402lint is an open-source MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.
x402lint probes the unpaid path of a pay-per-request endpoint and reports what a client or directory would trip over. It never pays and never signs, so it cannot test settlement; a clean result is explicitly not proof that revenue works.
Checks cover the challenge itself (version, accepts fields, CAIP-2 network, payTo format and checksum, integer base-unit amounts, EIP-712 hints for USDC), transport details such as GET versus POST agreement, redirects, cacheability and CORS headers, and discovery files like /.well-known/x402, /llms.txt and /openapi.json. A directory readiness mode lists what x402dash, x402scan, the402 and the Bazaar were known to check.
Results come as a verdict of ok, warn or fail with findings that carry an id, severity and fix. The same checks are available over a plain HTTP API and over the three MCP tools. A sibling CLI, paidpath, covers the paid path against your own endpoint.
Install
Run in a terminal
claude mcp add --transport http x402lint https://x402lint.something-agent.workers.dev/mcpAdd to Settings → Connectors → Add custom connector
https://x402lint.something-agent.workers.dev/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"x402lint": {
"url": "https://x402lint.something-agent.workers.dev/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"x402lint": {
"type": "http",
"url": "https://x402lint.something-agent.workers.dev/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"x402lint": {
"serverUrl": "https://x402lint.something-agent.workers.dev/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"x402lint": {
"type": "http",
"url": "https://x402lint.something-agent.workers.dev/mcp"
}
}
}Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- lint_x402_endpoint
- Fetches and lints an endpoint's unpaid 402 challenge.
- check_directory_readiness
- Reports readiness for known x402 directories.
- lint_payment_required
- Lints a payment-required challenge you already hold, with no network call.
What it does
- Challenge checks
- Validates fields, network, payTo, amount and EIP-712 hints.
- Transport checks
- Looks at redirects, caching, content type and CORS.
- Discovery checks
- Compares well-known files with the live challenge.
- Directory readiness
- Shows per-directory listing checks with sources.
- Lint a held challenge
- Check a pasted payment-required object with no network call.
- CI friendly
- Return a verdict that a script can test with jq.
Good for
- Check an x402 endpoint before announcing it
- Add a lint step to CI for a paid API
- See whether a directory would accept an endpoint
- Debug a CORS problem on a 402 response
Pricing
Open source
Free to use; MIT source
Prices change. Check x402lint.something-agent.workers.dev before you buy.
x402lint FAQ
Does it make payments?
No. It never pays or signs, so it cannot test settlement.
What does a clean lint mean?
Only that the unpaid path passes; it does not show that the route settles or delivers.
Which MCP tools are there?
lint_x402_endpoint, check_directory_readiness and lint_payment_required.
Is it open source?
The source is MIT licensed.
Is x402lint free?
Yes. x402lint is open source, so you can use and self-host it for free.
How do I add x402lint to Claude Code?
Run this command in your terminal: claude mcp add --transport http x402lint https://x402lint.something-agent.workers.dev/mcp
What are the best alternatives to x402lint?
The closest alternatives to x402lint are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to x402lint

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools