---
area: "directory"
title: "Directory"
tools: 11
mcp_server: "https://api.conecto.chat/mcp/directory"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/directory"
---

# Directory

The company's Microsoft Entra ID or Okta, run by the agent. It opens accounts for joiners, keeps titles and teams in step with HR, and suspends leavers with the owner's approval.

Replaces: Rippling IT, BetterCloud, manual onboarding tickets.

## MCP server

`https://api.conecto.chat/mcp/directory` connects the Directory tools only, plus the account tools that come with every MCP server. It speaks MCP over Streamable HTTP; send the key as `Authorization: Bearer <conecto_sk_ key>`. Every tool here is also a REST call: `POST https://api.conecto.chat/v1/tools/<name>` with the arguments as a JSON object.

## ChatGPT and Claude

Add `https://api.conecto.chat/v1/mcp` as a connector in ChatGPT or Claude, one for every area, and tick Directory when you sign in. It signs in with OAuth: someone on the account signs in on conecto.chat, ticks the areas it may use and allows it, and it runs on a key of its own that the owner can revoke.

## OpenAPI

For a custom GPT's Actions: `https://api.conecto.chat/v1/openapi/directory.json` (OpenAPI 3.0, the key as a Bearer token). For Power Automate, Logic Apps and Copilot Studio connectors: `https://api.conecto.chat/v1/openapi/directory.swagger.json` (OpenAPI 2.0, the key in the X-Api-Key header). Both list this area's tools and the account tools.

Prices: Reading free · each person added or suspended $0.25 · other changes $0.01 · connecting and restoring $0.001. A call that fails costs nothing.

## Tools

| Tool | What it does | Price |
|---|---|---|
| [directory_connect](https://conecto.chat/tools/directory/directory_connect.md) | Connects the company's Microsoft Entra ID or Okta, checked by reading one person. | $0.001 a call. |
| [directory_list_users](https://conecto.chat/tools/directory/directory_list_users.md) | People in the directory with their name, email, title, department and whether they can sign in. | Free up to 1,000,000 reads a month. |
| [directory_get_user](https://conecto.chat/tools/directory/directory_get_user.md) | One person in the directory by id or email. | Free up to 1,000,000 reads a month. |
| [directory_list_groups](https://conecto.chat/tools/directory/directory_list_groups.md) | The directory's groups with their id, name and description. | Free up to 1,000,000 reads a month. |
| [directory_create_user](https://conecto.chat/tools/directory/directory_create_user.md) | Opens a joiner's account with their title, department and groups; no password passes Conecto. | $0.25 a call. |
| [directory_update_user](https://conecto.chat/tools/directory/directory_update_user.md) | Changes a person's title, department or manager in the directory. | $0.01 a call. |
| [directory_set_groups](https://conecto.chat/tools/directory/directory_set_groups.md) | Adds a person to groups and takes them out of others. | $0.01 a call. |
| [directory_suspend_user](https://conecto.chat/tools/directory/directory_suspend_user.md) | Blocks a leaver's sign-in and ends their sessions, after the owner approves by default. | $0.25 a call. |
| [directory_restore_user](https://conecto.chat/tools/directory/directory_restore_user.md) | Lets a suspended person sign in again. | $0.001 a call. |
| [directory_sync_from_hr](https://conecto.chat/tools/directory/directory_sync_from_hr.md) | Sets titles and departments in the directory as HR has them; dry_run shows the plan first. | $0.01 a call. |
| [directory_disconnect](https://conecto.chat/tools/directory/directory_disconnect.md) | Forgets the directory's credentials; nothing in the directory changes. | Free. |

## Example jobs

- When Jonas starts in the warehouse on Monday, open his account and add him to the warehouse group.
- Every night, set titles and departments in the directory as HR has them.
- On Lena's last day, suspend her account and end her sessions, once the owner approves.