# x402 endpoint checker

> x402 endpoint checker is a free MCP server for cloud and infrastructure. Free checker that tests x402 paid URLs for 402 terms without paying, for sellers. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API, CLI
- **Website:** https://x402-seller-kit.soloearn.workers.dev/tools/x402-checker
- **MCP Registry name:** dev.workers.soloearn.x402-seller-kit/x402-checker
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure)
- **Listing updated:** 2026-11-18

## About

The checker sends an unpaid request to a payment-gated URL and grades the 402 response the way an x402 client or directory crawler would see it. It decodes the PAYMENT-REQUIRED header or JSON body, then reports on the payment options, network, USDC contract, amount units, payTo address checksum, EIP-712 domain values, CORS exposure and HEAD behaviour.

The tool never signs or pays anything. It makes one unpaid GET or POST, plus a HEAD request for GET checks, and returns a report with a verdict. Results are also available as JSON from an API endpoint, and as a read-only MCP tool named check_x402_endpoint for AI clients.

It suits people who run x402-priced APIs or downloads and want to catch configuration errors before buyers hit them, such as wrong amount units or a USDC domain mismatch. The site rate-limits checks to 20 per minute per IP and says it does not store the URLs submitted.

## Features

- **Unpaid 402 inspection:** Sends an unpaid request and reports whether the response is a proper 402 with x402 terms.
- **Payment option decoding:** Decodes v1 JSON bodies and v2 PAYMENT-REQUIRED headers into readable payment terms.
- **USDC and amount validation:** Checks the network, native USDC contract and amount units in smallest denominations.
- **EIP-712 domain comparison:** Compares extra name and version values with the USDC contract's on-chain values on supported networks.
- **CORS and HEAD checks:** Verifies browser-readable headers and that HEAD requests also return 402.
- **JSON API and MCP access:** Exposes the same checks through a GET endpoint and a streamable HTTP MCP server.

## Good for

- Verify an x402 paywall returns valid payment terms before launch
- Catch wrong USDC amount units or payTo addresses in a seller endpoint
- Confirm browser clients can read the PAYMENT-REQUIRED header via CORS
- Let an AI agent audit x402 endpoints through an MCP client

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http x402-checker https://x402-seller-kit.soloearn.workers.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://x402-seller-kit.soloearn.workers.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "x402-checker": {
      "url": "https://x402-seller-kit.soloearn.workers.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "x402-checker": {
      "type": "http",
      "url": "https://x402-seller-kit.soloearn.workers.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "x402-checker": {
      "serverUrl": "https://x402-seller-kit.soloearn.workers.dev/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://x402-seller-kit.soloearn.workers.dev/mcp
```

Enter a Name (for example "x402 endpoint checker"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "x402-checker": {
      "type": "http",
      "url": "https://x402-seller-kit.soloearn.workers.dev/mcp"
    }
  }
}
```

## Tools

All 1 tool say they're read-only. From the server's own tool annotations; not verified by us.

- `check_x402_endpoint` (says read-only): Fetch a paid URL without paying and grade its x402 402 challenge: status, PAYMENT-REQUIRED header, version, network, USDC asset, amount units, payTo checksum, EIP-712 domain, CORS, HEAD parity and discovery metadata. Read-only; never signs or pays.

## FAQ

### Is the x402 checker free?

Yes. It needs no signup, wallet or payment, and is limited to 20 checks per minute per IP.

### Does the checker pay or store the URLs I submit?

No. It sends one unpaid request (plus a HEAD request for GET), never creates a payment signature, and the site says it does not store checked URLs, only daily page-view counts.

### Does it support x402 v1 and v2?

Yes. It reads v2 terms from the base64 PAYMENT-REQUIRED header and v1 terms from the JSON body, mapping v1 network names to CAIP-2 IDs.

### Which networks are recognised?

Base, Base Sepolia, Ethereum, Polygon and Amoy, Avalanche and Fuji, Optimism, Arbitrum, Sei, IoTeX, Solana and Solana Devnet. Native USDC is checked on a subset of these; other tokens are reported as unknown.

### Is x402 endpoint checker free?

Yes. x402 endpoint checker is free to use.

### How do I add x402 endpoint checker to Claude Code?

Run this command in your terminal: claude mcp add --transport http x402-checker https://x402-seller-kit.soloearn.workers.dev/mcp

### What are the best alternatives to x402 endpoint checker?

The closest alternatives to x402 endpoint checker are x402 Precheck, 402xAgent, Code402, MoneyTools x402 Status & MCP Check and X402 List MCP.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [x402 Precheck](https://ai-powered.com/mcp/x402-precheck): x402 Precheck is a freemium MCP server for finance and payments.
- [402xAgent](https://ai-powered.com/mcp/402xagent): 402xAgent is a freemium MCP server for finance and payments.
- [Code402](https://ai-powered.com/mcp/code402): Code402 is a freemium MCP server for finance and payments.
- [MoneyTools x402 Status & MCP Check](https://ai-powered.com/mcp/moneytools-x402-status-and-mcp-check): MoneyTools x402 Status & MCP Check is a freemium MCP server for developer tools.
- [X402 List MCP](https://ai-powered.com/mcp/x402-list-mcp): X402 List MCP is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/x402-endpoint-checker
