<!-- Generated from Cogny's tool registry. Canonical page: https://cogny.com/integrations/aircall/tools -->

# Aircall tools in Cogny

Cogny's Aircall integration exposes 32 tools (20 read, 11 write, 1 destructive) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app.

- **Read** (20): only reads data.
- **Write** (11): creates or changes something.
- **Destructive** (1): deletes, removes or replaces something.

Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations.

## Notes

Aircall connects with an API ID and API Token from Company Settings → Integrations & API → API Keys (the token is shown only once when you create it). Cogny sends them as HTTP Basic auth to `api.aircall.io/v1`, acting on your whole Aircall company.

Cogny reads calls, transcripts and AI summaries, sentiments, topics, contacts, tags, users, availability, teams, numbers and outbound dialer campaigns, and writes call notes, call tags, contacts, tags, teams and campaign pauses. Starting an outbound call (`start_outbound_call`) would make the user's Aircall desktop app place a REAL phone call to an external number, so it is refused in code until the call is explicitly confirmed. Cogny never creates or deletes users, deletes recordings or voicemails, or sends SMS/WhatsApp messages.

## Known gaps

- Only six months of call history is available, and calls and contacts are capped at 10,000 items per query — pass `from`/`to` UNIX-timestamp windows to reach older ranges.
- Aircall rate-limits at 120 requests/minute per company.
- Transcripts, summaries, sentiments and topics are Conversation Intelligence features that need the AI Assist add-on on your plan; without it they return a friendly message.
- Launching an outbound dialer campaign is deliberately not exposed (it needs a compliance acknowledgment) — you can read, track and pause campaigns, not start one.

## All tools

| Tool | Kind | What it does |
|---|---|---|
| `ping` | Read | Check that the Aircall API is reachable with the configured credentials. |
| `list_calls` | Read | List calls, optionally within a from/to UNIX-timestamp window. |
| `get_call` | Read | Get one call by its Aircall call id. |
| `search_calls` | Read | Search calls by direction (inbound\|outbound), user_id, phone_number or tags (Aircall tag ids). |
| `get_call_transcription` | Read | Get the transcription of a call (Conversation Intelligence). |
| `get_call_summary` | Read | Get the AI summary of a call (Conversation Intelligence). |
| `get_call_sentiments` | Read | Get the sentiment analysis of a call (Conversation Intelligence). |
| `get_call_topics` | Read | Get the AI-detected topics of a call (Conversation Intelligence). |
| `list_users` | Read | List the users in your Aircall company. |
| `get_users_availability` | Read | List each user's availability (availability_status, substatus, wrap-up time) across the company. |
| `list_teams` | Read | List the teams in your Aircall company. |
| `get_team` | Read | Get one team by its Aircall team id. |
| `list_contacts` | Read | List the shared contacts in your Aircall company. |
| `search_contacts` | Read | Search the shared contacts in your Aircall company by phone_number, email, or within a from_/to UNIX-timestamp creation window. |
| `get_contact` | Read | Get one shared contact by its Aircall contact id. |
| `create_contact` | Write | Create a shared contact in Aircall. `first_name` and at least one `phone_number` (E.164 or any dialable format) are required; Aircall normalizes the number. |
| `update_contact` | Write | Update a shared contact's name/company/information fields. |
| `add_contact_phone_number` | Write | Add a phone number to a shared contact. `value` is the number (any dialable format; Aircall normalizes it). |
| `add_contact_email` | Write | Add an email to a shared contact. |
| `list_tags` | Read | List the tags in your Aircall company. |
| `create_tag` | Write | Create a tag in Aircall. `name` must be unique and non-blank; `color` must be a hex value like '#00B388'. |
| `list_numbers` | Read | List the phone numbers associated with your Aircall company. |
| `list_campaigns` | Read | List the outbound dialer campaigns in your Aircall company. `status` filters by draft\|in_progress\|paused\|completed\|archived (comma-separated for several). |
| `get_campaign` | Read | Get one outbound dialer campaign by its Aircall campaign id (a UUID). |
| `get_campaign_statistics` | Read | Get progress statistics for an outbound dialer campaign — how many contacts are done, how many remain, and how connected calls went. |
| `add_call_comment` | Write | Add a note (comment) to a call. `content` is the note text. |
| `add_call_tag` | Write | Apply one or more existing tags to a call. |
| `create_team` | Write | Create a team in Aircall. `name` must be unique and at most 64 characters. |
| `add_user_to_team` | Write | Add a user to a team. |
| `remove_user_from_team` | Destructive | Remove a user from a team. |
| `start_outbound_call` | Write | Place a REAL phone call to `to` from `user_id`'s Aircall app, refused until you pass `confirm=True` after the user approves. `number_id` is the Aircall number to call from, `to` the destination in E.164. |
| `pause_campaign` | Write | Pause an in_progress outbound dialer campaign — dialling stops for new attempts, and a call already in flight is allowed to finish. |

Exact input schemas come from `tools/list` once Aircall is connected; the free plan is enough to check.

Missing something? Your agent can ask for it with `request_feature`.

---

All integrations: https://cogny.com/integrations/tools/index.md
Plans, approvals, limits and data protection: https://cogny.com/buying-guide.md
What Cogny is: https://cogny.com/llms.txt
