Discovery Filters - StellarX402

All filters are accepted as query-string parameters on both /discovery/resources and /discovery/search. Multiple filters combine with AND semantics.

Payment filters

Filter	Type	Example	Notes
`network`	string	`stellar:pubnet`	CAIP-2 identifier.
`scheme`	string	`exact`, `upto`
`asset`	string	`USDC`	Symbol or contract address.
`maxPrice`	number	`0.01`	In human units of `asset`.
`minPrice`	number	`0.001`

Resource filters

Filter	Type	Example
`type`	`http` \| `mcp`	`type=mcp`
`tag`	string (repeatable)	`tag=weather&tag=forecast`
`payTo`	string	`GCKF...QMBA`

Result controls

Filter	Type	Default
`sort`	`rank` \| `price` \| `recent`	`rank`
`limit`	number	20 (max 100)
`cursor`	opaque string	none

Combining examples

# All MCP tools that summarize text, on mainnet, under 1 cent, sorted by price
curl "$FAC/discovery/search?q=summarize&type=mcp&network=stellar:pubnet&maxPrice=0.01&sort=price"

# All exact-scheme endpoints from a specific seller
curl "$FAC/discovery/resources?scheme=exact&payTo=GCKF...QMBA"

Behavior notes

Filters are validated. Unknown filters return 400 unknown_filter rather than being silently ignored.
Filters that reduce the result set to zero return 200 with an empty results array, not 404.