The pieces
- Automatic cataloging. Any endpoint that speaks x402 through this facilitator gets indexed. See Automatic Cataloging.
- Discovery metadata. Sellers describe what their endpoint does. That description is what search matches on. See Declaring Discovery Metadata.
- Search & ranking. Textual relevance, price, and recent activity combine into a rank. See Search & Ranking.
- Filters. Structured filters on network, price, asset, and capability. See Discovery Filters.
- MCP tools. MCP tool schemas are cataloged alongside HTTP endpoints. See Cataloging MCP Tools.
- Route template & catalog integrity. How dynamic routes stay uniquely addressable. See Route Template & Catalog Integrity.
The two endpoints
All discovery goes through two HTTP endpoints on the facilitator:
Both return the same listing shape. Use
/search when you have a query. Use /resources when you have filters.
Bazaar guarantees (and non-guarantees)
- Eventually consistent. New listings appear within seconds of the first
402. Removed listings drop from ranking within minutes. - No accounts. No seller registration, no reviews, no editorial control. If your endpoint speaks x402 through the facilitator, it is in.
- Not authoritative. The catalog reflects what sellers declare. Buyers still verify prices in the
402at request time.