HPP x402 MCP Bridge

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/hpp-io-x402-mcp-bridge

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

6 read · 7 write · 0 delete · 2 not yet classified

Secrets

1 (API keys, tokens or passwords)

Install scripts

Runs code on install

Runs as

Node.js package

Tools (15)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• hpp_call

  Call a service found via hpp_discover. Pass its `resourceId` and a `body` (the service's input args — check hpp_describe first if unsure). Payment (USDC.e) is handled automatically with your wallet, subject to the daily spend cap — you do not sign anything. HTTP, MCP and A2A typed services are all invoked directly; the price advertised by discovery is enforced as a ceiling.

• hpp_describe

  Describe one service found via hpp_discover: its input arguments (JSON Schema plus a concrete example body), output example, price, network and endpoint. Read-only — no payment. Call this before hpp_call when you are not certain what the service expects: hpp_call pays first and the seller validates after, so a wrong body costs a real payment.

• hpp_discover

  Discover paid x402 services on the HPP chain from the curated discovery directory. Returns services with their resourceId, name, description, price (USDC.e atomic units), network, type and trust signals (how many times the service has actually been paid). Pass `query` for a semantic search (e.g. 'image generation'), or omit it to browse. Results are limited to the network this wallet can pay on unless you pass `network` explicitly (use "all" to see every network). Then call hpp_describe({ resourceId }) to learn the input arguments, and hpp_call({ resourceId, body }) to run it.

• pay_a2a_agent

  Pay an external Agent2Agent (A2A) agent for one of its skills using x402 (exact scheme, USDC.e) and return the result. The operator supplies the agent's A2A endpoint URL (e.g. http://host:4021/a2a) and the skill id directly — this MVP does not yet fetch the AgentCard. The bridge gates (unpaid message/send), signs the x402 payment with its delegate wallet (subject to the daily spend cap), and re-sends with the payment in A2A metadata, returning the agent's output on success.

• seller_create_requirements

  Build an x402 PaymentRequirements object for a resource you sell. Returns the requirements to advertise in a 402 (see seller_generate_402). Scheme defaults to 'exact'; use 'upto' or 'batch-settlement' with scheme-specific fields in `extra`.

• seller_decode_payment

  Decode a buyer's base64 X-PAYMENT / Payment-Signature header locally (no facilitator call) to inspect the payload and extract the payer address. Supports exact / upto / batch-settlement.

• seller_generate_402

  Build the HTTP 402 Payment Required response body from one or more PaymentRequirements (from seller_create_requirements). Return this when a request arrives with no payment header.

• seller_receipt

  Build a portable execution receipt AFTER a successful seller_settle, binding the settled payment (tx + requirements) to the capability you ran and the result you returned. Pass the PaymentRequirements you advertised, the `transaction` from seller_settle, and the skill id + request + result. Returns a deterministic { receipt } any party can recompute and verify. Does NOT move funds — settle first.

• seller_settle

  Settle a verified payment on-chain AFTER the work succeeded (serve-then-settle). Pass the same X-PAYMENT header + PaymentRequirements. Returns { success, transaction }.

• seller_verify

  Verify a buyer's payment against the facilitator BEFORE doing the work. Pass the X-PAYMENT header + the PaymentRequirements you advertised. Returns { isValid, payer, invalidReason }.

• wallet_address

  Return this agent's own wallet address (to receive/fund USDC.e) and its network. Use when the user asks 'what's my address' or where to send funds.

• wallet_balance

  Show the wallet's current USDC.e balance — what it can spend right now. In Safe mode this is the delegate's immediately-spendable balance (the Safe tops up more on demand).

• wallet_get_limits

  Show the wallet's spend limits (per-call + per-day in atomic USDC.e units) and how much has been spent today. Empty limits = uncapped.

• wallet_set_limit

  Set the wallet's spend guard: a per-call cap and/or a per-day cap in atomic USDC.e units (e.g. '10000' = 0.01 USDC.e). These bind across ALL payment tools and are enforced locally before signing (complements the Safe's on-chain cap). Omit a field to leave it unchanged.

• x402_http_call

  Call an x402-protected HTTP endpoint and return its response. Payment (USDC.e) is handled automatically with your wallet, subject to the daily spend cap; per-host auth headers come from local policy (you do NOT pass keys). Only allow-listed hosts can be called. Use for paid HTTP APIs and account actions such as Hub credit top-up (POST <hub>/api/web3/credit/topup {amount}) and usage checks (GET <hub>/api/web3/credit/usage).

Signals

Stars

0

Forks

0

Open issues

2

Weekly downloads

318

Last commit

Oct 22, 2026 (6 days ago)

Last release

Oct 22, 2026 (6 days ago)

Last package publish

Oct 22, 2026 (6 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.hpp-io/x402-mcp-bridge

Version

0.1.23

Auth

API key

Packages

npm @hpp-io/x402-mcp-bridge

License

Apache-2.0

Repository

github.com/hpp-io/x402-mcp-bridge

Website

docs.hpp.io/x402/agents

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql