List payment directory endpoints

List cached MPP and x402 pay URLs with live probe classification. Defaults to payment_ready gates.

Tool

rill_list_directory

Each row includes pay_url, probe_status, probe_method, optional probe_amount_cents, probe_rails, optional probe_pay_to, and optional body_hint. MCP defaults to payment_ready=true and skips probes older than 7 days. Pass payment_ready=false for the full research catalog (docs/dead history). Prefer rill_discover for the curated can-pay set (Accept gates and partners). The bazaar catalog stays here.

Auth

No key required. Available on guest and full MCP sessions.

Parameters

Parameter	Type	Required	Description
`q`	string	no	Optional search filter
`rail`	string	no	mpp \| x402 \| any (default any)
`probe_status`	string	no	Comma list: payment_ready, docs_only, dead, auth_wall, unreachable, error, unknown, unprobed
`payment_ready`	boolean	no	MCP default true. Set false for the full catalog (not for spend).
`capability`	string	no	Filter by category (ai, data, search, blockchain, finance, compute, storage, web, commerce, content, social, infrastructure, verification, media, developer, other)
`max_probe_age_hours`	number	no	When listing payment_ready, drop rows older than this many hours (MCP default 168)
`limit`	number	no	Page size (1–100, default 50)
`cursor`	string	no	Pagination cursor from a previous response

Usage notes

Guest-safe discovery; does not move money.
Only trust payment_ready rows newer than ~7 days for rill_pay_url.
Owners refresh + re-probe with rill_sync_directory.
Same flow over HTTP: GET /directory.