
HPP x402 MCP Bridge
MCP bridge that lets an agent pay for x402 services in USDC.e within a spend cap
- Pricing
- Free
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 0.1.26
- Listing updated
- 3 days ago
About HPP x402 MCP Bridge
HPP x402 MCP Bridge is a free MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
Giving an agent a wallet is the point of this bridge. It adds payment tools to a host such as Claude Desktop, Claude Code, Cursor, Windsurf or OpenClaw so the agent can find a priced service, pay the exact price of one request and use the result. HPP's guide stresses three properties: pay per call, capped by what you fund (or by an on-chain daily allowance in Safe mode), and non-custodial, with the key held in the OS keychain.
Setup is a CLI step, hpp-x402 setup --install followed by the host name, which creates a wallet and registers the server. It targets HPP Sepolia by default and HPP Mainnet when configured, and needs Node 20 or later. Payments settle without native gas.
The README lists six host-facing tools. The per-call cap defaults to 1 USDC.e, and payments are limited to allowlisted tokens.
Install
Run in a terminal
claude mcp add x402-mcp-bridge --env DELEGATE_PRIVATE_KEY='<DELEGATE_PRIVATE_KEY>' -- npx -y @hpp-io/x402-mcp-bridgeAdd to claude_desktop_config.json
{
"mcpServers": {
"x402-mcp-bridge": {
"command": "npx",
"args": [
"-y",
"@hpp-io/x402-mcp-bridge"
],
"env": {
"DELEGATE_PRIVATE_KEY": "<DELEGATE_PRIVATE_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"x402-mcp-bridge": {
"command": "npx",
"args": [
"-y",
"@hpp-io/x402-mcp-bridge"
],
"env": {
"DELEGATE_PRIVATE_KEY": "<DELEGATE_PRIVATE_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"x402-mcp-bridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@hpp-io/x402-mcp-bridge"
],
"env": {
"DELEGATE_PRIVATE_KEY": "<DELEGATE_PRIVATE_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"x402-mcp-bridge": {
"command": "npx",
"args": [
"-y",
"@hpp-io/x402-mcp-bridge"
],
"env": {
"DELEGATE_PRIVATE_KEY": "<DELEGATE_PRIVATE_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"x402-mcp-bridge": {
"command": "npx",
"args": [
"-y",
"@hpp-io/x402-mcp-bridge"
],
"env": {
"DELEGATE_PRIVATE_KEY": "<DELEGATE_PRIVATE_KEY>"
}
}
}
}Configuration
DELEGATE_PRIVATE_KEYDelegate EOA private key used to sign payments. Auto-created in the OS keychain if unset.HPP_NETWORKTarget network: eip155:181228 (HPP Sepolia, default) or eip155:190415 (HPP Mainnet).RESOURCE_SERVER_URLOptional upstream MCP server to proxy. Omit to expose only the local tools.SAFE_ADDRESSSafe address for governance (Safe) mode. Set together with ALLOWANCE_MODULE_ADDRESS.ALLOWANCE_MODULE_ADDRESSSafe AllowanceModule address for governance (Safe) mode. Set together with SAFE_ADDRESS.
Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- wallet_address
- Reports the wallet address so it can be funded.
- hpp_discover
- Lists and searches the curated HPP service directory.
- hpp_describe
- Shows one service's input schema and example.
- hpp_call
- Calls a discovered HTTP, MCP or A2A service and pays from the wallet.
- x402_http_call
- Pays and calls any x402 HTTP endpoint.
- pay_a2a_agent
- Pays and messages another A2A agent.
What it does
- Capped spending
- Spending stops at the amount funded, or at the Safe allowance.
- Service discovery
- Searches HPP's curated directory and shows a service's input schema before paying.
- Pay any x402 endpoint
- Calls and pays arbitrary x402 HTTP endpoints or other A2A agents.
- Keychain wallet
- Stores the delegate key in the OS keychain rather than a plain file.
- Smart Wallet option
- Can pay from an HPP Smart Wallet under a delegated limit.
Good for
- Let an agent buy API calls without a signup
- Give a coding agent a small budgeted wallet
- Pay another A2A agent for a task
- Browse paid services from the terminal with the CLI
Pricing
Free
Bridge is free to install; paid services charge per call
Prices change. Check docs.hpp.io before you buy.
HPP x402 MCP Bridge FAQ
Which networks does it use?
HPP Sepolia by default and HPP Mainnet when set through HPP_NETWORK.
What tokens can it pay in?
USDC.e by default; CHIP and HPP are also allowed where services price in them.
Does it need gas?
The guide says settlement is gasless, so no native gas is needed.
Is HPP x402 MCP Bridge free?
Yes. HPP x402 MCP Bridge is free to use.
How do I add HPP x402 MCP Bridge to Claude Code?
Run this command in your terminal: claude mcp add x402-mcp-bridge --env DELEGATE_PRIVATE_KEY='<DELEGATE_PRIVATE_KEY>' -- npx -y @hpp-io/x402-mcp-bridge
What are the best alternatives to HPP x402 MCP Bridge?
The closest alternatives to HPP x402 MCP Bridge are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.
Alternatives to HPP x402 MCP Bridge

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government