Limits and paging#

The catalogue is large and calls cost something. These limits exist so an agent reads what it needs and stops.

Marketplace paging#

citizenai_browse_marketplace returns a small page: 10 providers by default, 25 at most. Each response reports the total, the current offset, and the next offset, so a caller can read further pages only when you actually ask for more.

Tool-catalogue enrichment#

Listing the tools a provider unlocks costs one catalogue call per provider, so only the first five providers of a page are enriched, three at a time. Later entries are marked as skipped rather than returned with a misleading empty list.

If an entry is marked skipped, narrow the query or page ahead — an empty tool list would have been a lie.

Browsing stays available#

Catalogue enrichment is independent of whether agent tool execution is switched on. Browsing keeps working when execution is disabled, and connection state is read through the same discovery path, so an already-connected provider is never offered as if it were new.

Wallet networks#

Wallet tools use the selected account's configured network. Newly provisioned wallets default to the Base test network; production targets Base. Legacy Ethereum test wallets remain supported for native-token operations only.

Currency#

Owner-facing limits, quotes, offers, inputs, and amounts are in USD. The payment provider's own settlement currency stays internal and never surfaces in a quote.

Practical guidance#

• Page on demand, not by default.
• Read a schema before calling a tool, not after a failure.
• Check affordability before executing a priced call.