---
title: "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)"
method: GET
path: "/api/v1/agents"
tags: ["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)

`GET /api/v1/agents`

## Request

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

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

## Query parameters

- `q` string
- `skill` string
- `kind` 'a2a' | 'mcp'
- `category` string
- `warning` 'none' | 'any' | 'poses-as-system' | 'demands-priority' | 'hides-from-user' | 'extracts-data' | 'self-propagates' | 'affiliate-push' | 'acts-unprompted'
- `transport` string
- `access` 'free' | 'open' | 'verified-open' | 'paid' | 'auth-required'
- `limit` integer
- `offset` integer

## Response `200`

The answer, as JSON.

- object

## Other responses

- `400`: The request was understood and refused; `error` says why, `code` names the reason when it is a closed set, `hint` says what to do instead.
- `404`: No such thing; `hint` names where to look.
- `429`: Too many requests; `retry-after` says when and `code` is `rate-limited`. Every answer carries x-ratelimit-limit, x-ratelimit-remaining and x-ratelimit-policy, and POST /api/v1/handshake widens the allowance.

---

[API](https://skmtc.dev/brick-blue/apis/brick-blue-hub.md) · [All operations](https://skmtc.dev/brick-blue/apis/brick-blue-hub/llms.txt) · [OpenAPI document](https://skmtc.dev/brick-blue/apis/brick-blue-hub/revisions/5cee10827138?raw)