Skip to main content
GET
Search the catalog

Query Parameters

query
string
required

What to find, in natural language. 1 to 500 characters after trimming. Longer than 500 after trimming is search_query_too_long; longer than 2,000 is discovery_invalid_parameter.

Maximum string length: 2000
type
string

Only listings of this resource type. Unknown types match nothing.

Pattern: ^[a-z][a-z0-9_-]{0,31}$
Examples:

"http"

"mcp"

payTo
string

Only payment options paying this address (a G… address also matches muxed addresses on it).

Pattern: ^[A-Z2-7]{56}$|^M[A-Z2-7]{68}$
scheme
string

Only payment options in this scheme.

Pattern: ^[a-z][a-z0-9_-]{0,31}$
Example:

"exact"

network
string

Only payment options on this CAIP-2 network.

Pattern: ^[-a-z0-9]{3,8}:[-_a-zA-Z0-9]{1,64}$
Example:

"stellar:testnet"

extensions
string

Comma-separated extension keys (at most 10) every resource must declare in its 402 response.

Pattern: ^[a-zA-Z0-9_-]{1,64}(,[a-zA-Z0-9_-]{1,64}){0,9}$
Example:

"bazaar"

asset
string

Only payment options in this asset, by C… contract address or symbol.

Pattern: ^C[A-Z2-7]{55}$|^[A-Za-z0-9]{1,12}$
maxPrice
string

Price ceiling, in the asset's units if asset is set, else in US dollars.

Pattern: ^\d{1,15}(\.\d{1,18})?$
limit
integer
default:10

Page size, in resources. Values above 50 are clamped to 50.

Required range: x >= 1
cursor
string

The pagination.cursor of the previous page.

Maximum string length: 512

Response

A page of results, best first.

x402Version
integer
required
resources
object[]
required
partialResults
boolean
required

True when the semantic ranking was cut at its depth, or a ranked (not filter-only) search ran lexical-only because no model is loaded or embedding the query failed or took over 2 seconds.

pagination
object
required
rail402
object
required