graph_search_users
Search the organization directory by name or email to find users. Returns identifying fields or full records, with next-link paging for large result sets.
Instructions
Search for users in the organization directory by name or email.
Graph does not support $skip alongside $search on /users, so page with
next_link instead of an offset.
Args: query: Name or email address to look up. top: Maximum number of users to return (default 10, maximum 25). compact: Whether to return only the identifying fields instead of the full record (default false). Use it to page through large collections cheaply. next_link: Opaque nextLink URL from a previous call, used to fetch the next page. Overrides the other paging arguments when supplied. include_next_link: Whether to wrap the result as {items, next_link} so paging can continue (default false, which returns a bare list).
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": "graph_search_users"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | ||
| query | Yes | ||
| compact | No | ||
| next_link | No | ||
| include_next_link | No |