addrbook directory

find_agents (search by capability/URL/host/wallet/heading) and get_agent (single record lookup) share a resource and could be momentarily confused, but the descriptions make the search-vs-fetch split explicit. list_headings targets a clearly different resource (directory sections with counts), so boundaries are largely clear.

All three tools follow a consistent snake_case verb_noun pattern: find_agents, get_agent, list_headings. Verb choice (find/get/list) matches each tool's semantics predictably.

Three tools is a small but coherent surface for a read-oriented directory service: search, fetch one record, and browse section headings. It is slightly thin — no bulk/paged listing — but each tool earns its place with no filler.

The read path is covered (search, detail, headings), but there is no way to publish, register, or update a listing, nor to paginate or enumerate all listings beyond a heading count. For a directory that agents may also want to join or correct, these are notable gaps.