Search ENS names
search_namesSearch ENS names by label, e.g. 'Find names starting with vitalik'. Matches from the start of a label by default, or anywhere with match: contains. Set namespace to basenames to search *.base.eth names. Results come from an indexer and can lag the chain by a few blocks; for one name's authoritative state use get_name_details.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_names"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Items per page, 1 to 100. Default: 25 | |
| match | No | prefix (default): labels starting with the query; contains: anywhere | |
| query | Yes | Text to look for in names, e.g. vitalik | |
| cursor | No | cursor from the previous page, to read the next one | |
| namespace | No | ens (default), or basenames for *.base.eth names on Base |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asOf | No | Chain time the indexer's answer reflects | |
| items | Yes | ||
| total | No | ||
| cursor | No | Pass back as cursor for the next page; absent on the last page | |
| partial | No | Why the answer may be incomplete |