> ## Documentation Index
> Fetch the complete documentation index at: https://docs.madra.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Discovery Overview

> How the Bazaar catalogs paid endpoints and MCP tools, and the pieces that make search work.

The Bazaar is StellarX402's discovery layer. It exists so that agents can find paid endpoints without a human wiring URLs in by hand. This page is the map. The pages after it are the details.

## The pieces

* **Automatic cataloging.** Any endpoint that speaks x402 through this facilitator gets indexed. See [Automatic Cataloging](/discovery/automatic-cataloging).
* **Discovery metadata.** Sellers describe what their endpoint does. That description is what search matches on. See [Declaring Discovery Metadata](/guides/sellers/declaring-discovery-metadata).
* **Search & ranking.** Textual relevance, price, and recent activity combine into a rank. See [Search & Ranking](/discovery/search-and-ranking).
* **Filters.** Structured filters on network, price, asset, and capability. See [Discovery Filters](/discovery/filters).
* **MCP tools.** MCP tool schemas are cataloged alongside HTTP endpoints. See [Cataloging MCP Tools](/discovery/cataloging-mcp-tools).
* **Route template & catalog integrity.** How dynamic routes stay uniquely addressable. See [Route Template & Catalog Integrity](/discovery/route-template-and-integrity).

## The two endpoints

All discovery goes through two HTTP endpoints on the facilitator:

| Endpoint                                               | Purpose                                                          |
| ------------------------------------------------------ | ---------------------------------------------------------------- |
| [`GET /discovery/resources`](/api/discovery-resources) | Structured filter across the catalog. Returns paginated results. |
| [`GET /discovery/search`](/api/discovery-search)       | Free-text ranked search across the catalog.                      |

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 `402` at request time.