Is X402 Mcp Bridge free?

Yes, X402 Mcp Bridge is free to use.

How do I install X402 Mcp Bridge?

X402 Mcp Bridge is a local plugin. Install it using npm package: @hpp-io/x402-mcp-bridge and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is X402 Mcp Bridge safe to use?

X402 Mcp Bridge scored 5.2/10 (moderate risk) in MCP Marketplace's automated security scan. It has 2 high or critical findings to review. It's listed, but review the security report on this page before installing.

What credentials does X402 Mcp Bridge need?

X402 Mcp Bridge requires the following credentials or environment variables: DELEGATE_PRIVATE_KEY, HPP_NETWORK, RESOURCE_SERVER_URL, SAFE_ADDRESS, ALLOWANCE_MODULE_ADDRESS. You can find setup instructions on the server detail page.

What AI apps work with X402 Mcp Bridge?

X402 Mcp Bridge uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

X402 Mcp Bridge MCP Server

by Hpp Io

Developer ToolsModerate5.2MCP RegistryLocal

Free

Server data from the Official MCP Registry

MCP bridge for autonomous x402 payments in HPP USDC.e — discover and pay for services per call.

About

MCP bridge for autonomous x402 payments in HPP USDC.e — discover and pay for services per call.

Security Report

5.2

Moderate5.2Moderate Risk

This is a legitimate MCP server for agent payments on HPP using x402 protocol. The code is well-structured with proper authentication via private key management and reasonable permission scoping. However, there are moderate concerns around private key handling in CLI tools, some input validation gaps, and a dependency on external payment infrastructure that users should understand. The server's permissions align well with its stated purpose. Supply chain analysis found 2 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.

5 files analyzed · 13 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

HTTP Network Access

Connects to external APIs or services over the internet.

keychain_access

Check that this permission is expected for this type of plugin.

process_spawn

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Delegate EOA private key used to sign payments. Auto-created in the OS keychain if unset.Required

Environment variable: DELEGATE_PRIVATE_KEY

Target network: eip155:181228 (HPP Sepolia, default) or eip155:190415 (HPP Mainnet).Optional

Environment variable: HPP_NETWORK

Optional upstream MCP server to proxy. Omit to expose only the local tools.Optional

Environment variable: RESOURCE_SERVER_URL

Safe address for governance (Safe) mode. Set together with ALLOWANCE_MODULE_ADDRESS.Optional

Environment variable: SAFE_ADDRESS

Safe AllowanceModule address for governance (Safe) mode. Set together with SAFE_ADDRESS.Optional

Environment variable: ALLOWANCE_MODULE_ADDRESS

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-hpp-io-x402-mcp-bridge": {
      "env": {
        "HPP_NETWORK": "your-hpp-network-here",
        "SAFE_ADDRESS": "your-safe-address-here",
        "RESOURCE_SERVER_URL": "your-resource-server-url-here",
        "DELEGATE_PRIVATE_KEY": "your-delegate-private-key-here",
        "ALLOWANCE_MODULE_ADDRESS": "your-allowance-module-address-here"
      },
      "args": [
        "-y",
        "@hpp-io/x402-mcp-bridge"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

@hpp-io/x402-mcp-bridge

The agent payment rail for HPP. A stdio MCP bridge + the hpp-x402 CLI that let Claude Desktop / Claude Code / Cursor / Windsurf / OpenClaw make autonomous HPP USDC.e payments over x402 — discover paid services, pay per call, within a spend cap. No API keys, no manual signing.

📖 Full documentation

hpp-io/x402-tools — the complete manual: how it works, every command, buyer and seller flows, payment schemes (exact / upto), wallet modes, and troubleshooting. This README is a quick reference.

Install

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/hpp-io/x402-tools/main/install/install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/hpp-io/x402-tools/main/install/install.ps1 | iex
# …or npm
npm install -g @hpp-io/x402-mcp-bridge

Needs Node 20+. On a headless box (no OS keychain) use setup --print-key — see the manual.

Quick start

hpp-x402 setup --install claude-code   # create a wallet + register into your host
hpp-x402 fund                          # where to send USDC.e (gasless, no native gas)
hpp-x402 status                        # confirm it's wired

Restart your host and your agent can discover and pay for services. Browse and pay from the terminal too:

hpp-x402 discover --limit 5                        # shows type · scheme · price · URL · id
hpp-x402 call <url-or-id> --body '{"hi":"there"}'  # pay + call — a URL, or an id from discover

Full command reference, selling (serve), schemes, and Safe mode → the manual.

Use it from an MCP host

The host spawns the bridge over stdio. A bare entry boots zero-config on HPP Sepolia with an auto-created keychain wallet:

{ "mcpServers": { "hpp-x402": {
  "command": "npx", "args": ["-y", "@hpp-io/x402-mcp-bridge"]
} } }

hpp-x402 install <host> writes this for you. Note: a bare npx @hpp-io/x402-mcp-bridge runs the MCP server (what the host wants) — for the CLI use npx -y -p @hpp-io/x402-mcp-bridge hpp-x402 <command>.

Host-facing tools

Tool	What it does
`wallet_address`	report your wallet address (to fund it)
`hpp_discover`	list/search the curated HPP directory (read-only)
`hpp_call`	call a discovered service; pays via your wallet
`x402_http_call`	pay + call any x402 HTTP endpoint
`pay_a2a_agent`	pay + message another A2A agent

Every paid call stays within your spend cap; discovery never holds funds or sees your keys.

Key env (all optional)

Var	Notes
`DELEGATE_PRIVATE_KEY`	auto-created in the OS keychain if unset
`HPP_NETWORK`	`eip155:181228` Sepolia (default) / `eip155:190415` Mainnet
`RESOURCE_SERVER_URL`	proxy one upstream MCP server (omit = local tools only)
`SAFE_ADDRESS` + `ALLOWANCE_MODULE_ADDRESS`	set both = Safe (governance) mode

Full environment reference + Safe/governance setup are in the manual.

Building an agent / SDK integration (LangChain, OpenAI function-calling, AgentKit, A2A)? See the runnable gallery → hpp-io/hpp-x402-agent-sample

License

Apache-2.0

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

X402 Mcp Bridge MCP Server

About

Security Report

Findings (13)Action required

Permissions Required

What You'll Need

How to Install

Documentation

@hpp-io/x402-mcp-bridge

📖 Full documentation

Install

Quick start

Use it from an MCP host

Host-facing tools

Key env (all optional)

Related

License

Reviews

No reviews yet

More Developer Tools MCP Servers

Fetch

Toleno

mcp-creator-python

MarkItDown

MCP Marketplace

FinAgent