find_site
Resolve a site name or controller ID to exact matches, returning candidates and flagging ambiguous results so you can choose the correct site.
Instructions
Resolve a human site name or exact ID without guessing.
Returns every matching candidate. If more than one site matches, the result is explicitly marked ambiguous so the caller can choose an exact site.
Args:
name: Site name or controller ID. Exact ID match wins first, then
exact name match (case-insensitive), then falls back to a
substring match. Multiple hits are never auto-picked — check
ambiguous in the result and call again with a more specific
name or the exact id from sites.
cursor: Opaque pagination token copied from a previous response's
next_cursor. Omit on the first call.
limit: Max matches to return in this page. Omit to use the server
default page size (50; max 200).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Site name or controller ID. Exact ID match wins first, then exact name match (case-insensitive), then falls back to a substring match. Multiple hits are never auto-picked — check `ambiguous` in the result and call again with a more specific name or the exact `id` from `sites`. | |
| limit | No | Max matches to return in this page. Omit to use the server default page size (50; max 200). | |
| cursor | No | Opaque pagination token copied from a previous response's `next_cursor`. Omit on the first call. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |