HPP x402 MCP Bridge

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.

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

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.

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.

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.

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

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.

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.

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.