# Aircall MCP MCP > Aircall MCP manages your entire cloud phone system through natural language conversation. Your agent can read call logs, manage shared contacts, check team availability, and audit number configurations. Stop switching between dashboards; get all communication data in one place. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** call-center, business-phone, call-logs, team-collaboration, voice-analytics, customer-service ## Description This connector gives your AI client deep access to your Aircall business phone system. You tell the agent what you need—whether it's checking a colleague’s status or digging into call recordings—and it handles the whole sequence of tasks for you. It centralizes everything: contact management, team structure, and communication history. Instead of manually looking up details across different tabs, your agent retrieves structured data by calling specific endpoints like `list_calls` or `search_contacts`. Everything runs through Vinkius's catalog system, so you connect once and get access to all the operational tools needed for a modern support workflow. You can quickly check team assignments using `list_users`, verify phone number setups with `get_number_details`, and even build new contacts using `create_contact`—all via simple conversation. ## Tools ### create_contact Adds a brand new contact record to your Aircall address book. ### get_call_details Retrieves the specific technical details about any past call. ### get_number_details Fetches the detailed configuration of an Aircall phone number. ### get_user_details Checks a specific user's current availability status within the team. ### list_calls Retrieves a list of recent call logs for auditing purposes. ### list_contacts Provides a simple listing of all contacts stored in your Aircall account. ### list_numbers Gives you an overview list of all phone numbers assigned to the account. ### list_teams Lists every team or departmental group defined in Aircall. ### list_users Retrieves a directory listing of all active users and members. ### search_contacts Searches your contact database using a specific phone number or name query. ## Prompt Examples **Prompt:** ``` List the last 10 calls made by my team. ``` **Response:** ``` I've retrieved your recent calls. You had 10 calls in the last hour, with an average duration of 4 minutes. 3 were inbound and 7 were outbound. Would you like to see the recordings for any of them? ``` **Prompt:** ``` Search for a contact with name 'John Doe'. ``` **Response:** ``` I've found 2 contacts matching 'John Doe'. One is at 'Future Corp' and the other is a private contact. Which one would you like to see the details for? ``` **Prompt:** ``` Check if user 'Jane Smith' is currently available for calls. ``` **Response:** ``` I've checked Jane Smith's status. She is currently 'Busy' on another call. Her average call duration is 5 minutes, so she might be free soon. Would you like me to check again in a moment? ``` ## Capabilities ### Review Call Records List and retrieve technical details for past calls, including who was involved and how long they lasted. ### Manage Contact Data Create new records or search your existing database of contacts by name or phone number. ### Check Team Status See which team members are available, busy, or assigned to specific departments. ### Audit Phone Numbers Get the technical configuration and details for every phone number tied to your account. ### List Team Structures Retrieve a list of all active teams or departments within your organization's Aircall setup. ## Use Cases ### Investigating a Missed Call A sales rep needs to know who called back yesterday. They prompt their agent: 'What calls were logged for John Doe last week?' The agent uses `list_contacts` and then `search_contacts`, returning all relevant call metadata so the rep can follow up without manual searching. ### Onboarding a New Team Member An operations lead needs to set up a new user account. They first use `list_users` to check existing roles, then use `get_number_details` to verify the assigned line before creating and updating records via `create_contact`. ### Post-Meeting Followup A support agent finishes a call. They ask their agent to summarize the interaction by looking up the contact's history using `search_contacts`, allowing them to update internal notes and CRM data immediately after hanging up. ### System Readiness Check The manager needs to confirm all departmental phones are configured correctly before a major campaign launch. They use `list_teams` followed by multiple calls to `get_number_details`, confirming every line is active and assigned. ## Benefits - Review call logs efficiently. Instead of navigating the dedicated logging dashboard, you simply ask your agent to use `list_calls` and get summarized data immediately. - Centralize contact information. You can create new records using `create_contact` or find existing ones quickly with `search_contacts`, eliminating the need for multiple manual lookups. - Understand team availability instantly. Use `get_user_details` to check if a colleague is free before initiating a call, saving time and preventing dropped calls. - Audit system health easily. Verify phone number setups using `get_number_details` or listing all numbers with `list_numbers` without diving into complex admin portals. - Streamline team oversight. You can check departmental assignments by calling `list_users` or view the full organizational structure via `list_teams` in one go. ## How It Works The bottom line is you talk to your agent naturally, and it talks to Aircall for you, returning structured data in real time. 1. Subscribe to this MCP and provide the necessary API ID and token for your Aircall account. 2. Connect the credentials to your preferred AI client (like Claude or Cursor). 3. Start by prompting your agent with a natural language request, such as 'List all active users in the Sales team,' and it executes the required tool calls. ## Frequently Asked Questions **How do I find my Aircall API ID and Token?** Log in to your Aircall Dashboard, navigate to **Integrations & API** > **API keys**, and create a new key. You will see both the `api_id` and `api_token` there. **Can I listen to call recordings via the agent?** The `get_call_details` tool provides the URL to the call recording if available. Your agent can retrieve this metadata, and you can access the link to listen to the audio. **Does this support checking user availability?** Yes! Use the `get_user_details` tool. It returns the current availability status (Available, Busy, or Offline) for any team member in your account. **If I use the `create_contact` tool, does it check for existing contacts before adding a new one?** Yes. The MCP first checks if a contact with that phone number or email already exists in your Aircall account. If it finds a match, it prevents creating a duplicate entry and lets you update the record instead. **What specific metadata can I retrieve using `get_call_details`?** This tool provides deep technical information on calls, including SIP headers, connection IDs, and exact timestamps. It’s for auditing or troubleshooting, not just a summary of who called whom. **When should I use `list_numbers` versus the `get_number_details` tool?** `list_numbers` gives you a quick overview and status report of all your assigned lines. You must run `get_number_details` when you need specific configuration data, like port settings or technical features. **How can I narrow down user results by department using the `list_users` tool?** You provide a team ID as an argument to `list_users`. This filters out all other employees and returns only the members assigned to that specific Aircall team. **What fields can I use to filter results when calling `search_contacts`?** The `search_contacts` tool accepts parameters for name, phone number, or email. You can combine these filters—for instance, searching by a specific phone prefix and a partial name.