Service directory
The HPP x402 directory is the catalog of paid x402 services on HPP. It's how an agent finds something to pay for without being handed a URL — the discovery layer that makes autonomous, agentic payments practical.
You browse it at x402-explorer.hpp.io, the HPP x402 Explorer.
How a service gets listed
Two paths, and you don't have to choose in advance:
- Auto-indexed. On a service's first settled payment, the facilitator publishes the
settlement and the directory indexes the service — its URL, price, scheme, network, and
description (advertised via the
@x402Bazaar extension;hpp-x402 servedoes this by default). Nothing to sign up for. Pass--private, or omit the metadata, to stay unlisted. - Seller-registered. The seller signs in at My services and registers the service, proving ownership of the payout address with a signature. That listing carries a Verified badge and can be edited, delisted, and given an on-chain identity.
Because listing is anchored in real settlements and signed ownership, the directory is a trust signal: entries are services that have actually been paid for, or whose payout wallet has proven it controls them — not self-submitted claims.
Browse it
As a human — the Explorer catalog searches by intent ("check a wallet for sanctions") across both HPP networks.
From an agent — the Explorer is an MCP server; see
Connect an agent. The bridge also exposes hpp_discover,
so an agent can search the directory and pay in the same session.
From the CLI:
hpp-x402 discover --limit 10 # everything, newest first
hpp-x402 discover "compute" -t http # search + filter by type
hpp-x402 discover --scheme upto # only usage-based services
Each result shows type · scheme · price · network · URL · id. Pay one with
hpp-x402 call <url-or-id>.
REST API
The directory is a read-only REST service — useful for building your own explorer or agent tooling.
| Endpoint | Returns |
|---|---|
GET /discovery/resources?type&network&limit&offset | a page of listed services |
GET /discovery/search?q&type&network&limit | full-text + semantic search |
GET /discovery/resources/:id | one service's full detail (metadata, schema, trust signals) |
curl "https://x402-explorer.hpp.io/discovery/resources?type=http&limit=5"
Filters: type (http / mcp / a2a), network (CAIP-2, e.g. eip155:190415), and limit /
offset for paging.
Related
- Find a service — a visual walkthrough of the Explorer.
- List your service — get your own service into the catalog.
- Pay from an AI agent — give an agent access to the directory.
- How it works — the
402flow and payment schemes.