x402 Universal Payer MCP Server

One MCP server that can pay any x402-paid endpoint on the open web - the universal x402 payer for AI agents.

People connecting AI & ML tools to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

One of 37 MCP servers published from nirholas/three.ws. Stars and repository activity are shared across all of them. See all 37 →

VERIFIED ACTIVE

LAST COMMIT 2026-08-24 · VERIFIED 2026-08-25

Apache-2.0 · JavaScript servers · how we verify → /methodology

01 · Install x402 Universal Payer

before you install - you'll need

Set MCP_BRIDGE_EVM_PRIVATE_KEY, MCP_BRIDGE_SVM_PRIVATE_KEY, MCP_BRIDGE_DISCOVER_LIMIT before connecting. MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC is optional or environment-specific per the README.

Claude Code

claude mcp add nirholas-three.ws-mcp-bridge -- npx -y @three-ws/mcp-bridge

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "nirholas-three.ws-mcp-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/mcp-bridge"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license Apache-2.0 - declared in the repository

npm package @three-ws/mcp-bridge - the @three-ws scope differs from the repo owner (nirholas); confirm it's the project's official package

registry namespace io.github.nirholas is GitHub-verified and matches the repo owner

03 · What x402 Universal Payer can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 1 documented tool, including list_bazaar_tools.

The 1 tools it gives your agent

Extracted from the project's README - what x402 Universal Payer lets an agent do.

list_bazaar_tools
- readOnlyHint: true, idempotentHint: true, openWorldHint: false. Pure in-process cache read; free, no network.

04 · Who maintains x402 Universal Payer

x402 Universal Payer is maintained by nirholas. We track 66 MCP servers from nirholas - 65 actively maintained, 7,658 combined GitHub stars, oldest repo from Feb 2024. Full record: all servers from nirholas.

  1. Metaplex Agent Registry Deploy AI agents on-chain on Solana with an EIP-8004 identity. Deploy fee funds $THREE buybacks. ★ 102
  2. pump.fun Solana Data Free, read-only pump.fun + Solana MCP: token discovery, on-chain analysis, SNS, 3D snapshots. ★ 102
  3. Alibaba Cloud DashScope - Qwen Alibaba Cloud DashScope MCP: Qwen chat, embeddings, and model discovery on your own account. ★ 102
  4. three.ws Agent Payments Governed x402 payment sessions: pay any endpoint with budget, allowlist & per-tx caps, no key. ★ 102
  5. three.ws Brain List LLM providers and run chat completions through the three.ws multi-provider router. ★ 102
  6. three.ws 3D Agent Tools MCP tools from three.ws: free + paid text-to-3D, rigging, agent reputation, market intel. ★ 102

05 · Facts

category
AI & ML - actively maintained as of 2026-08-25.
registry
io.github.nirholas/x402-bridge (active, first published 2026-06-13 · 3 versions)
packages
npm:@three-ws/mcp-bridge

06 · x402 Universal Payer FAQ

What is x402 Universal Payer?

One MCP server that can pay any x402-paid endpoint on the open web - the universal x402 payer for AI agents.

Is x402 Universal Payer still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-24. We re-verify nightly.

How do I install x402 Universal Payer?

Run `npx -y @three-ws/mcp-bridge`. The README documents 4 environment variables (MCP_BRIDGE_EVM_PRIVATE_KEY, MCP_BRIDGE_SVM_PRIVATE_KEY, MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC…) to set first. Set MCP_BRIDGE_EVM_PRIVATE_KEY, MCP_BRIDGE_SVM_PRIVATE_KEY, MCP_BRIDGE_DISCOVER_LIMIT before connecting. MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does x402 Universal Payer run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to x402 Universal Payer