MCP Server

x402-market MCP Server

Name: x402-market MCP Server
Author: io.github.AsaiShota

io.github.AsaiShota/mcp-server

Repository Registry

What is the x402-market MCP server?

Let AI agents pay-per-call for any HTTP API via x402 on Base mainnet. One tool: pay_and_call.

How to install x402-market

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

MARKET_API_URL
Marketplace API base URL.
MCP_BUYER_PRIVATE_KEY
secret
Funded buyer wallet private key (0x-prefixed). Required for pay_and_call; read-only tools work without it.
BASE_RPC_URL
Base RPC endpoint. Defaults to Base mainnet public RPC; Alchemy/QuickNode recommended for higher rate limits.
BASE_CHAIN_ID
8453 = Base mainnet (default, matches live listings). 84532 = Base Sepolia testnet.
MCP_MAX_PRICE
Hard cap on per-call cost (USDC). Refuses to pay above this.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@x402-market/mcp-server"
      ],
      "env": {
        "MARKET_API_URL": "<YOUR_MARKET_API_URL>",
        "MCP_BUYER_PRIVATE_KEY": "<YOUR_MCP_BUYER_PRIVATE_KEY>",
        "BASE_RPC_URL": "<YOUR_BASE_RPC_URL>",
        "BASE_CHAIN_ID": "<YOUR_BASE_CHAIN_ID>",
        "MCP_MAX_PRICE": "<YOUR_MCP_MAX_PRICE>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@x402-market/mcp-server"
      ],
      "env": {
        "MARKET_API_URL": "<YOUR_MARKET_API_URL>",
        "MCP_BUYER_PRIVATE_KEY": "<YOUR_MCP_BUYER_PRIVATE_KEY>",
        "BASE_RPC_URL": "<YOUR_BASE_RPC_URL>",
        "BASE_CHAIN_ID": "<YOUR_BASE_CHAIN_ID>",
        "MCP_MAX_PRICE": "<YOUR_MCP_MAX_PRICE>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@x402-market/mcp-server"
      ],
      "env": {
        "MARKET_API_URL": "<YOUR_MARKET_API_URL>",
        "MCP_BUYER_PRIVATE_KEY": "<YOUR_MCP_BUYER_PRIVATE_KEY>",
        "BASE_RPC_URL": "<YOUR_BASE_RPC_URL>",
        "BASE_CHAIN_ID": "<YOUR_BASE_CHAIN_ID>",
        "MCP_MAX_PRICE": "<YOUR_MCP_MAX_PRICE>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@x402-market/mcp-server"
      ],
      "env": {
        "MARKET_API_URL": "<YOUR_MARKET_API_URL>",
        "MCP_BUYER_PRIVATE_KEY": "<YOUR_MCP_BUYER_PRIVATE_KEY>",
        "BASE_RPC_URL": "<YOUR_BASE_RPC_URL>",
        "BASE_CHAIN_ID": "<YOUR_BASE_CHAIN_ID>",
        "MCP_MAX_PRICE": "<YOUR_MCP_MAX_PRICE>"
      }
    }
  }
}

Claude Code

claude mcp add mcp-server --env MARKET_API_URL=<YOUR_MARKET_API_URL> --env MCP_BUYER_PRIVATE_KEY=<YOUR_MCP_BUYER_PRIVATE_KEY> --env BASE_RPC_URL=<YOUR_BASE_RPC_URL> --env BASE_CHAIN_ID=<YOUR_BASE_CHAIN_ID> --env MCP_MAX_PRICE=<YOUR_MCP_MAX_PRICE> -- npx -y @x402-market/mcp-server