---
title: Read-only A2A domain-selection concierge
description: Delegate a domain shortlist using the anonymous Namegarage catalog.
url: https://namegarage.com/docs/a2a
---


# Select domains with A2A

No account, API key, cookie or Authorization header is required.
Read the [A2A 1.0 Agent Card](https://namegarage.com/.well-known/agent-card.json).
Send JSON-RPC requests to `https://namegarage.com/api/a2a` with `A2A-Version: 1.0`.
The service returns a direct Message, with no stored task or conversation.
Repeat the full brief and filters on each request; a context ID is correlation only.

```json
{"jsonrpc":"2.0","id":"shortlist-1","method":"SendMessage","params":{"message":{"messageId":"brief-1","role":"ROLE_USER","parts":[{"data":{"query":"a collaborative project planner","max_price":3000,"tld":"com","limit":5}}]}}}
```

Use one `data` part with `query` (2–200 characters) and optional `max_price`
(positive whole USD), `tld`, `max_length`, `tier`, and `limit` (1–10; default 5).
A single plain `text` part can describe a project. Put hard constraints in the
structured fields: constraints embedded in prose return `clarification_required`
without searching. Ambiguous numerical or suffix-like wording can also ask you
to rephrase the description. Files, URLs, multiple briefs and unknown fields are refused.

The response has `result.message`, with `ROLE_AGENT`, a server message ID,
and your supplied `contextId` (or a new one). Its JSON part contains `status`,
`priced_at`, `meaning`, `count`, `results` and `guidance`. A text part repeats
published names, prices, descriptions and potential uses. `acceptedOutputModes`
may select `application/json`, `text/plain`, or both.

Results retain catalog ranking and all typed filters. Null prices mean offer-only;
a price cap excludes them. Empty results ask you to revise the brief. Missing
published descriptions remain empty. Potential uses do not establish suitability
or trademark rights. Prices and availability can change; open the returned listing
before deciding. The service cannot buy, reserve, register or transfer a name.

Each selection uses one existing catalog search. The shared limits remain
30 requests per IP per minute and 120 searches globally per minute. Busy or
unverified catalog responses are JSON-RPC errors, preserving HTTP status and
`Retry-After`. Requests are limited to 16384 bytes, a 5-second body deadline and a
10-second work deadline. No streaming, push notifications or extended card is
supported. `GetTask` and `CancelTask` return task-not-found; `ListTasks` is empty.

Existing [HTTP and SDK](https://namegarage.com/docs/quickstart.md) and
[MCP](https://namegarage.com/mcp/) clients remain anonymous and compatible.