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.7/10 (moderate risk) in MCP Marketplace's automated security scan. It has 1 high or critical finding 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.7MCP 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.7

Moderate5.7Moderate Risk

The x402-mcp-bridge is a payment-enabled MCP server for autonomous USDC.e transactions with generally sound architecture and appropriate auth mechanisms. However, several code quality and operational security concerns exist: inadequate input validation in discovery/HTTP tools, potential timing race conditions in spend guard logic, overly broad error messages that could leak information, and missing validation of external RPC responses. These issues don't constitute critical vulnerabilities but represent moderate risks that should be addressed. Supply chain analysis found 2 known vulnerabilities in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

5 files analyzed · 12 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.

HTTP Network Access

Connects to external APIs or services over the internet.

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.

system_info

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 "price prediction"               # semantic search; your network only
hpp-x402 describe <id>                             # input args (schema + example) — no payment
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_describe`	one service's input args — schema + example (read-only)
`hpp_call`	call a discovered service (HTTP/MCP/A2A); 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
`HPP_PAYMENT_DELEGATION`	ERC-7710 payment delegation a wallet granted to this key: pays `erc7710` accepts from the user's smart account under on-chain caps — this key needs no USDC.e. Validated at boot; without it such accepts are skipped

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!

4.8

Local

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 (12)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

Git

Fetch

Worldmonitor

Paperclip

Toleno

mcp-creator-python