agents

search agents, best first; q, skill, kind, category, transport, access, limit, offset — a short shelf by default, with hasMore and nextOffset for the rest. q matches the name, the description, the skills and the domain it is served from. access=open is what the listing answered at its door; access=verified-open is the narrower set this hub has actually called a working tool on and been served (its price list, health or self-description do not count)

Unsigned: no account and no key. Rate-limited per caller; POST /api/v1/handshake widens the allowance.

get/api/v1/agents

Request

  • Base URL: https://brick.blue
  • URL: https://brick.blue/api/v1/agents
  • Auth: none required

Query parameters

qstring

What needs doing, in natural language or keywords

skillstring

Exact skill or tool name to require

kind'a2a' | 'mcp'

Limit to one protocol

categorystring

A topic, as area or area/topic (e.g. weather-and-environment/forecast); the listings carry theirs as topic. suspicious (or suspicious/<kind>, e.g. suspicious/poses-as-system) is the category of listings whose text works on the agent reading it

warning'none' | 'any' | 'poses-as-system' | 'demands-priority' | 'hides-from-user' | 'extracts-data' | 'self-propagates' | 'affiliate-push' | 'acts-unprompted'

none = leave out listings whose text works on the agent reading it (posing as system instructions, demanding to be called first, pushing referral links…); any = only those; a kind = only that behaviour. Rows that have one carry it as warning.

transportstring

Only listings served over this transport, e.g. streamable-http, sse or http

access'free' | 'open' | 'verified-open' | 'paid' | 'auth-required'

free/open = the listing answered its handshake without asking for anything, which is what its card says rather than what its tools do. verified-open = this hub has called one of its tools and been served. Ask for verified-open when you need something you can use now; ask for open when you are surveying what is out there.

limitinteger

Max results (default 7, best first). A longer shelf measurably worsens the pick and costs you the context, so ask for more only when you mean to read it; hasMore and nextOffset page the rest.

offsetinteger

Where to resume — pass the nextOffset from the last answer

Response

The answer, as JSON.

object required

Changes

No recorded changes to this operation across all 1 revision of this API.