enumerate_entities
Enumerate ENS-friendly labels for a finite real-world entity category and report which are available vs registered.
USE THIS for ANY finite set of real-world people, companies, teams, or works — including queries that name a ROLE or PROFESSION rather than a league, e.g. "which tech founders have an available .eth?", "available CEOs / politicians / authors / footballers", "famous musicians I can register", "NBA hall of famers", "available Pixar films", "F1 drivers", "Beatles songs that are open". If the user is asking to find/register the names of actual real-world entities (not a vibe or an ENS club), this is the tool — even when the category sounds soft ("tech founders", "crypto founders", "famous CEOs") it is still a finite real-world list, so come straight here; do NOT fall back to search_ens_names for it. The tool generates verified, correctly-spelled ENS labels — do NOT enumerate entity names from your own context and pass them to check_availability, because models routinely misspell long-tail names (scottiepippin instead of scottiepippen) or invent people who don't exist (e.g. "johncarlton" as an NBA HOFer). This tool exists precisely to avoid that.
DO NOT use this for:
Vibes / themes ("luxury watch names", "edgy crypto names") — use search_ens_names with concept_search instead.
ENS-native categories ("10k club", "3-letter words") — use search_ens_names with collection_search.
Single-name lookups — use check_availability.
Returns a list of entries grouped by status. Each entry has the proper name (e.g. "Scottie Pippen") alongside the ENS label (scottiepippen.eth), so you can show users the human-readable name in your reply.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filter | No | Which slice to return. "available" = registerable names only (most common for "what can I buy" queries). "registered" = names already owned. "all" = both, with status. Default: all. | all |
| category | Yes | Real-world entity category ONLY — e.g. "NBA hall of fame players", "Pixar feature films", "F1 world champions", "US presidents", "Italian cities", "Beatles songs". Be specific ("NBA hall of famers" good; "basketball players" too broad), but pass a CLEAN category with NO extra qualifiers: strip availability/quality/price words such as "available", "cheap", "star", "famous", "best", "top" — those are not part of the category and pollute the lookup. For availability, set the "filter" param instead; never put it in the category text. |