List groups
The directory's groups with their id, name and description.
Free*
*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.
An example
Which groups do we have for the warehouse?
Your agent callsdirectory_list_groupsFree*
The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.
{
"query": "warehouse"
}Use it when
To find the group ids a joiner should get.
What it does
The directory's groups, with their id, name and description (which apps and teams they open).
What comes back
groups: each with id, name and description; count. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
query | string | Up to 100 characters. |
limit | integer | 1 to 200. Default: 100. |
The call
Over MCP, call directory_list_groups on https://api.conecto.chat/mcp/directory. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/directory_list_groups \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"warehouse"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_connected409 | No directory is connected yet. | Connect Entra ID or Okta with directory_connect. |
directory_rejected502 | The directory refused, usually because a permission is missing. | Ask its admin to grant what the message names. |
directory_unavailable503 | The directory could not be reached. | Try again in a minute; nothing changed. |
More Directory tools
All 11 tools- Create an account for a joiner
directory_create_userOpens a joiner's account with their title, department and groups; no password passes Conecto.$1.00 a call - Update a person in the directory
directory_update_userChanges a person's title, department or manager in the directory.$0.01 a call - Change a person's groups
directory_set_groupsAdds a person to groups and takes them out of others.$0.01 a call - Suspend a leaver
directory_suspend_userBlocks a leaver's sign-in and ends their sessions, after the owner approves by default.$1.00 a call - Restore a suspended person
directory_restore_userLets a suspended person sign in again.$0.001 a call - Bring the directory in line with HR
directory_sync_from_hrSets titles and departments in the directory as HR has them; dry_run shows the plan first.$0.01 a call - Disconnect the directory
directory_disconnectForgets the directory's credentials; nothing in the directory changes.Free - Connect the directory
directory_connectConnects the company's Microsoft Entra ID or Okta, checked by reading one person.$0.001 a call
Read next: What is an MCP server?
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md