{
  "markdown": "# @hpp-io/x402-mcp-bridge\n\n[![npm](https://img.shields.io/npm/v/@hpp-io/x402-mcp-bridge?logo=npm)](https://www.npmjs.com/package/@hpp-io/x402-mcp-bridge)\n[![MCP Registry](https://img.shields.io/badge/MCP_Registry-listed-1f6feb)](https://registry.modelcontextprotocol.io/?q=x402-mcp-bridge)\n[![License](https://img.shields.io/badge/license-Apache--2.0-green)](./LICENSE)\n[![Node](https://img.shields.io/badge/node-%3E%3D20-3c873a?logo=node.js)](https://nodejs.org)\n\n> The agent payment rail for HPP. A stdio MCP bridge + the `hpp-x402` CLI that let\n> Claude Desktop / Claude Code / Cursor / Windsurf / OpenClaw make autonomous\n> **HPP USDC.e** payments over [x402](https://x402.org) — discover paid services,\n> pay per call, within a spend cap. No API keys, no manual signing.\n\n## 📖 Full documentation\n\n**[hpp-io/x402-tools](https://github.com/hpp-io/x402-tools)** — the complete manual:\nhow it works, every command, buyer **and** seller flows, payment schemes\n(exact / upto), wallet modes, and troubleshooting. This README is a quick reference.\n\n## Install\n\n```bash\n# macOS / Linux\ncurl -fsSL https://raw.githubusercontent.com/hpp-io/x402-tools/main/install/install.sh | bash\n# Windows (PowerShell)\nirm https://raw.githubusercontent.com/hpp-io/x402-tools/main/install/install.ps1 | iex\n# …or npm\nnpm install -g @hpp-io/x402-mcp-bridge\n```\n\nNeeds Node 20+. On a headless box (no OS keychain) use `setup --print-key` — see\nthe [manual](https://github.com/hpp-io/x402-tools#requirements).\n\n## Quick start\n\n```bash\nhpp-x402 setup --install claude-code   # create a wallet + register into your host\nhpp-x402 fund                          # where to send USDC.e (gasless, no native gas)\nhpp-x402 status                        # confirm it's wired\n```\n\nRestart your host and your agent can discover and pay for services. Browse and pay\nfrom the terminal too:\n\n```bash\nhpp-x402 discover \"price prediction\"               # semantic search; your network only\nhpp-x402 describe <id>                             # input args (schema + example) — no payment\nhpp-x402 call <url-or-id> --body '{\"hi\":\"there\"}'  # pay + call — a URL, or an id from discover\n```\n\nFull command reference, selling (`serve`), schemes, and Safe mode →\nthe **[manual](https://github.com/hpp-io/x402-tools)**.\n\n## Use it from an MCP host\n\nThe host spawns the bridge over stdio. A bare entry boots zero-config on HPP\nSepolia with an auto-created keychain wallet:\n\n```jsonc\n{ \"mcpServers\": { \"hpp-x402\": {\n  \"command\": \"npx\", \"args\": [\"-y\", \"@hpp-io/x402-mcp-bridge\"]\n} } }\n```\n\n`hpp-x402 install <host>` writes this for you. Note: a bare\n`npx @hpp-io/x402-mcp-bridge` runs the MCP **server** (what the host wants) — for\nthe CLI use `npx -y -p @hpp-io/x402-mcp-bridge hpp-x402 <command>`.\n\n### Host-facing tools\n\n| Tool | What it does |\n|------|--------------|\n| `wallet_address` | report your wallet address (to fund it) |\n| `hpp_discover` | list/search the curated HPP directory (read-only) |\n| `hpp_describe` | one service's input args — schema + example (read-only) |\n| `hpp_call` | call a discovered service (HTTP/MCP/A2A); pays via your wallet |\n| `x402_http_call` | pay + call any x402 HTTP endpoint |\n| `pay_a2a_agent` | pay + message another A2A agent |\n\nEvery paid call stays within your spend cap; discovery never holds funds or sees\nyour keys.\n\n### Key env (all optional)\n\n| Var | Notes |\n|-----|-------|\n| `DELEGATE_PRIVATE_KEY` | auto-created in the OS keychain if unset |\n| `HPP_NETWORK` | `eip155:181228` Sepolia (default) / `eip155:190415` Mainnet |\n| `RESOURCE_SERVER_URL` | proxy one upstream MCP server (omit = local tools only) |\n| `SAFE_ADDRESS` + `ALLOWANCE_MODULE_ADDRESS` | set both = Safe (governance) mode |\n\nFull environment reference + Safe/governance setup are in the\n[manual](https://github.com/hpp-io/x402-tools).\n\n## Related\n\nBuilding an agent / SDK integration (LangChain, OpenAI function-calling, AgentKit,\nA2A)? See the runnable gallery →\n[hpp-io/hpp-x402-agent-sample](https://github.com/hpp-io/hpp-x402-agent-sample)\n\n## License\n\nApache-2.0\n",
  "bytes": 4038,
  "sha": "3dec4c303bbc6f24f099ce98497d64867c88e12e6985ee31be6fe157a65ec8d3",
  "repo_slug": "hpp-io/x402-mcp-bridge",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_hpp_io_x402_mcp_bridge_ee86728d/readme"
}