x402

@codespar/mcp-x402 · v0.1.5

🌐 GlobalProtocolsAuth · API Keybeta10 tools4 env varsdeprecated on npm

HTTP-native micropayments by Coinbase. USDC on Base and Solana. Machine-to-machine payments with HTTP 402.

Deprecated on npm: No live endpoint: api.x402.org does not resolve. See https://github.com/codespar/mcp-dev-latam/tree/main/packages/crypto/x402

Get started · free View docs

MIT · deprecated on npm

Limitations

The package manifest does not declare 3 of the 4 variables the code reads.
The npm package ships no server.json manifest.

DetailsSource on GitHub

Package: @codespar/mcp-x402
Version: 0.1.5
npm dist-tag: latest
Category: Protocols
Auth: API Key
Country: 🌐 Global
License: MIT
Transport: stdio · streamable-http

npm GitHub Server catalog docs

Quickstart

Before you use it.

This package is deprecated on npm, so this page offers no install command or client config. No live endpoint: api.x402.org does not resolve. See https://github.com/codespar/mcp-dev-latam/tree/main/packages/crypto/x402

Hosted MCP Build your own server

Environment variables4 variables

X402_API_KEYAPI key for x402requiredsecret

X402_BASE_URLRead by the code; the package manifest does not declare it.

X402_NETWORKRead by the code; the package manifest does not declare it.

X402_WALLET_ADDRESSRead by the code; the package manifest does not declare it.

Names read from the package code (@codespar/mcp-x402@0.1.5). Descriptions and flags come from its manifest. Self-hosted, you hold the credentials.

Tools

What your agent can call.

10 tools, as the package's tools/list returns them.

pay_request

Pay for a 402-protected resource. Sends USDC payment via x402 protocol and returns the resource content. The agent automatically handles the 402 handshake.

verify_payment

Verify if a x402 payment was received and settled on-chain

create_paywall

Create a x402 paywall configuration for an endpoint. When requests hit this endpoint, they receive HTTP 402 with payment instructions.

get_paywall

Get paywall configuration for a specific URL

list_paywalls

List all configured x402 paywalls

delete_paywall

Remove a x402 paywall from an endpoint

get_balance

Get available USDC balance for x402 payments

list_payments

List x402 payment history with optional filters

get_payment

Get details of a specific x402 payment

get_supported_networks

List supported blockchain networks, tokens, and facilitators for x402 payments

Names and descriptions come from the package's tools/list (@codespar/mcp-x402@0.1.5). A kind (read, write, delete) is shown only when the package annotates its tools or each tool was verified one by one; neither exists for this server yet.

Compatibility

MCP is a protocol. Any client that speaks it can mount this server.

The CodeSpar runtime does not route this server. Mount it in your client over stdio · streamable-http.

Protocol

Any MCP client

stdio · streamable-http

Questions

Before you install.

How do I install the x402 MCP server?

The npm package @codespar/mcp-x402 is deprecated, so this page shows no install command for it. The registry says: No live endpoint: api.x402.org does not resolve. See https://github.com/codespar/mcp-dev-latam/tree/main/packages/crypto/x402

What can my agent do with x402?

x402 exposes 10 tools for protocols. Your agent calls them directly; the full list is above.

How does x402 authenticate, and how are credentials stored?

x402 uses API Key. Self-hosted, you hold the credentials: the server reads them from its environment variables.

How does x402 handle upstream API changes?

Every server is versioned independently on npm. This one is deprecated (see the notice above), so the page does not suggest pinning a version.

Is x402 open source? How do I report a bug?

Yes. x402 is MIT-licensed and published on npm as @codespar/mcp-x402, source on GitHub (link in the Details panel). Report issues on the package repository; security issues go to security@codespar.dev, and we respond within 24 hours.

Pairs well with