Find entries by handle
find_by_handleWhich public entries list a handle: “is x.com/someone an official account, and whose?”. Give a profile’s address as url (https://x.com/someone), or platform (its catalog id: twitter, instagram, youtube, …) and value (someone or @someone). Answers each entry’s VHID, title and URL, the handle as the entry lists it, and whether that handle is verified; an empty list when no entry lists it. Case is ignored where the platform ignores it. Email addresses are not looked up.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "find_by_handle"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | A profile’s address, such as https://x.com/someone. Instead of platform and value. | |
| value | No | The handle on that platform, such as someone or @someone. | |
| platform | No | The platform’s catalog id, such as twitter. With value. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| value | Yes | The handle looked up, as the site stores one: from `url`, what follows the platform’s address. | |
| results | Yes | Verified handles first, then by VHID; at most 50. Empty when no public entry lists it. | |
| platform | Yes | The platform looked on: the one asked, or the one whose address `url` is. |