Skip to content
MCP server

HPP x402 MCP Bridge

MCP bridge that lets an agent pay for x402 services in USDC.e within a spend cap

Runs locallyStatus and history
Install
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-bridge

Add 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

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government