Skip to content
MCP server

x402lint

Lint the unpaid 402 challenge of an x402 payment endpoint before you list it

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://x402lint.something-agent.workers.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "x402lint": {
      "url": "https://x402lint.something-agent.workers.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools