Skip to content
MCP server

X402 MCP Server

JMT x402: 35 pay-per-call Base/USDC tools for agents, auto-paid via x402 v2. No API key.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
2.0.1
Listing updated
5 days ago

About X402 MCP Server

X402 MCP Server is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add x402-mcp-server -- npx -y @jmthomasofficial/x402-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "x402-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jmthomasofficial/x402-mcp-server"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "x402-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jmthomasofficial/x402-mcp-server"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "x402-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@jmthomasofficial/x402-mcp-server"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "x402-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jmthomasofficial/x402-mcp-server"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "x402-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jmthomasofficial/x402-mcp-server"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • JMT_X402_PRIVATE_KEYBase-mainnet wallet private key (funded with USDC). Used only to sign x402 payment authorizations. Never logged.

Pricing

Open source

X402 MCP Server FAQ

Is X402 MCP Server free?

Yes. X402 MCP Server is open source, so you can use and self-host it for free.

How do I add X402 MCP Server to Claude Code?

Run this command in your terminal: claude mcp add x402-mcp-server -- npx -y @jmthomasofficial/x402-mcp-server

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers