# Aircall MCP for AI Agents AI Agent Connect > Aircall MCP lets your AI agent take over the heavy lifting of managing your business phone system. You can ask your agent to pull up call recordings, update shared contacts, or check if a teammate is actually free to take a call. It turns your Aircall account into a conversational workspace where you can audit logs and manage numbers without digging through a dashboard. ## Overview - **Category:** communication-messaging - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_ETVhJrvL5GimAmnahIOEU1A3eMM4d8pH7Yagdb6b/ai-agent-connect - **Tags:** call-center, business-phone, call-logs, team-collaboration, voice-analytics, customer-service ## Description Managing a high-volume phone system usually means jumping between tabs, searching for specific call recordings, and manually updating contact info in a separate CRM. It's a lot of friction for a team that just wants to talk to customers without the overhead of constant data entry. This Connector changes that by letting you talk to your Aircall data directly through your AI client. Instead of hunting for a specific conversation from last Tuesday, you just ask your agent to find it. You can also keep your team's availability updated or find a specific phone number's configuration without logging into the admin panel. It makes your communication platform feel like a part of your actual conversation rather than a separate tool you have to manage. You'll find this is a huge win when you're looking for Vinkius to host your core integrations, as it keeps everything in one place. You can audit call trends, manage private contacts, and keep your team's status clear, all while staying inside the chat interface you're already using to get work done. It takes the manual labor out of the backend and lets you focus on the people on the other end of the line. You no longer have to worry about missing a detail in a long log or guessing which department a specific user belongs to. Your agent handles the heavy lifting of data retrieval so you can make faster decisions. ## Tools ### list_calls Get a list of all call logs from your account. Use this to quickly review recent activity and call history. ### search_contacts Find a contact by searching for their phone number. Use this to quickly locate a specific person in your database. ### create_contact Add a new contact to your shared or private list. This lets you update your database without leaving your chat. ### list_users See all the team members currently on your account. Use this to get a full view of your staff and their assignments. ### get_call_details Pull technical data and recordings for a specific call. This helps you see the exact duration and metadata for any conversation. ### list_contacts See all the contacts stored in your Aircall account. This is useful for auditing your shared and private contact lists. ### get_user_details Check the current availability status of a specific team member. This helps you see if someone is busy or free to talk. ### list_numbers Get a list of all the phone numbers assigned to your account. Use this to keep track of your business lines. ### get_number_details View the configuration details for a specific phone number. This is great for auditing technical settings. ### list_teams See the different teams and departments set up in your account. Use this to understand your full organizational structure. ## Prompt Examples **Prompt:** ``` Show me the last 5 calls from our Sales team. ``` **Response:** ``` I've pulled the last 5 calls from the Sales department for you: | Time | Duration | Participant | | :--- | :--- | :--- | | 10:15 AM | 4m 20s | Jane Doe | | 09:45 AM | 12m 05s | Mark Smith | | 09:30 AM | 2m 45s | Sarah Chen | | 09:15 AM | 8m 12s | Robert Fox | | 08:50 AM | 5m 30s | Emily Wong | Would you like to see the recordings for any of these? ``` **Prompt:** ``` Is Sarah from Support available to take a call? ``` **Response:** ``` I've checked Sarah's status. She is currently **Busy** on another call. * **Current Call Duration:** 4 minutes * **Estimated Free Time:** ~2 minutes Would you like me to check again in a moment? ``` **Prompt:** ``` Find the contact for 555-0199 and add a note that they're a VIP. ``` **Response:** ``` I found the contact for **555-0199**: * **Name:** John Doe * **Company:** Future Corp I've updated the contact record to include the note: **VIP Customer**. Is there anything else you need for this account? ``` ## Capabilities ### Pull up call logs See a list of past calls with durations and metadata. ### Check call recordings Get the specific details and files for a past conversation. ### Find specific contacts Search your shared or private contact list by phone number. ### Update contact info Create or edit contact records in your Aircall account. ### Monitor team status See who is busy, away, or available across different departments. ### Audit phone numbers View the technical configurations for your business lines. ### List team members See everyone on your account and their assigned teams. ## Use Cases ### The Post-Call Follow-up A support rep asks the agent to find the last call from a specific customer and summarize the issues discussed to prepare for a follow-up. ### The Team Availability Check A manager asks if anyone in the Billing team is free to take an urgent call right now to avoid interrupting someone who is already busy. ### The Contact Cleanup An ops lead asks the agent to find a contact by phone number and update their company name to keep the shared database accurate. ### The Performance Audit A supervisor asks to see the call logs for the last 24 hours to identify peak volume times and staffing needs. ## Benefits - Faster Call Auditing: Use list_calls and get_call_details to find specific recordings in seconds instead of clicking through pages of history. This saves your team from manual searching and lets you jump straight into the content of the conversation. - Instant Contact Updates: Create or update shared contacts with create_contact without leaving your chat window to open a new tab. This keeps your database current while you're still focused on your current task. - Real-time Team Oversight: Check get_user_details to see if a teammate is busy or free before you try to reach out to them. It prevents unnecessary interruptions and helps with better workload distribution. - Simplified Number Management: Use list_numbers and get_number_details to audit your technical configurations and assignments quickly. This is a huge time saver for operations leads managing large fleets of lines. - Better Data Organization: Use list_teams and list_users to get a clear picture of your departmental structure and staffing at a glance. This makes it easier to see how your organization is scaled. ## How It Works The bottom line is you get a conversational interface for your entire phone system. 1. Connect your Aircall account by providing your API ID and Token in the Vinkius dashboard. 2. Open your preferred AI client like Claude, Cursor, or Windsurf. 3. Ask your agent to perform tasks like 'Find the last call from John Doe' or 'Show me who is on the Sales team.' ## Frequently Asked Questions **Can the Aircall MCP help me find call recordings?** Yes, it lets your agent pull up specific call details and recordings based on your request. You can find them by asking for specific dates or participants. **How do I check if my team members are busy?** You can ask your agent to check the live status of any user in your account. It will tell you if they are busy, away, or available. **Can I update my contacts using the Aircall MCP?** Yes, your agent can create new contacts or update existing ones in your shared list. This helps keep your data current without leaving your chat. **Does the Aircall MCP work for auditing phone numbers?** It lets you list all your numbers and see their technical configurations. This is great for operations teams who need to audit their business lines. **Can I see which team a user belongs to?** Your agent can list all teams and users to show you the full organizational structure. This makes it easy to see who is assigned to which department. **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.