MCP bridge for autonomous x402 payments in HPP USDC.e — discover and pay for services per call.
HPP X402 MCP Bridge MCP server exists for a simple reason — assistants are far more useful when they can act on HPP X402 MCP Bridge directly instead of describing what you should do. MCP bridge for autonomous x402 payments in HPP USDC.e — discover and pay for services per call.
Needs Node 20+. On a headless box (no OS keychain) use setup --print-key — see the manual.
Installation goes through your MCP client rather than a global install: point it at @hpp-io/x402-mcp-bridge on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.
Once HPP X402 MCP Bridge is connected, these are the calls the assistant has available:
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 walletx402_http_call — pay + call any x402 HTTP endpointpay_a2a_agent — pay + message another A2A agentYou will need 2 environment variables: DELEGATE_PRIVATE_KEY, RESOURCE_SERVER_URL. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
Among the file and storage access options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. HPP X402 MCP Bridge's toolset — wallet_address, hpp_discover, hpp_describe and 3 more — is a fair guide to whether it matches your workflow. It is maintained by hpp-io; worth a glance at recent repository activity before you build anything load-bearing on it.
SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.
| 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 |
{
"mcpServers": {
"x402-mcp-bridge": {
"command": "npx",
"args": ["-y", "@hpp-io/x402-mcp-bridge"],
"env": {
"DELEGATE_PRIVATE_KEY": "your-value",
"RESOURCE_SERVER_URL": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| DELEGATE_PRIVATE_KEY | Credential the server authenticates with. | Yes |
| RESOURCE_SERVER_URL | Endpoint or connection string the server talks to. | Yes |
Scoped local file access — read, write, search and reorganise files in directories you explicitly allow.
Search and read your Drive — Docs, Sheets and files become context your assistant can actually use.
Query, modify and analyse local SQLite databases in conversation — the fastest way to chat with a data file.
Build a programmable telecommunications stack for connecting telephony services with the Internet via a cloud-based utility.
Chat with your second brain — search, read and write vault notes through the Local REST API.
Connects AI models to an Obsidian knowledge base for direct access and manipulation of notes and folders.