# HPP x402 MCP Bridge

> HPP x402 MCP Bridge is a free MCP server for finance and payments. MCP bridge that lets an agent pay for x402 services in USDC.e within a spend cap. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://docs.hpp.io/x402/agents
- **Repository:** https://github.com/hpp-io/x402-mcp-bridge
- **MCP Registry name:** io.github.hpp-io/x402-mcp-bridge
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add x402-mcp-bridge --env DELEGATE_PRIVATE_KEY='<DELEGATE_PRIVATE_KEY>' -- npx -y @hpp-io/x402-mcp-bridge
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "x402-mcp-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@hpp-io/x402-mcp-bridge"
      ],
      "env": {
        "DELEGATE_PRIVATE_KEY": "<DELEGATE_PRIVATE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "x402-mcp-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@hpp-io/x402-mcp-bridge"
      ],
      "env": {
        "DELEGATE_PRIVATE_KEY": "<DELEGATE_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "x402-mcp-bridge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@hpp-io/x402-mcp-bridge"
      ],
      "env": {
        "DELEGATE_PRIVATE_KEY": "<DELEGATE_PRIVATE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "x402-mcp-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@hpp-io/x402-mcp-bridge"
      ],
      "env": {
        "DELEGATE_PRIVATE_KEY": "<DELEGATE_PRIVATE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "x402-mcp-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@hpp-io/x402-mcp-bridge"
      ],
      "env": {
        "DELEGATE_PRIVATE_KEY": "<DELEGATE_PRIVATE_KEY>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/hpp-x402-mcp-bridge
