# Aircall MCP

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** call-center, business-phone, call-logs, team-collaboration, voice-analytics, customer-service

## Tools

### list_calls
List call logs

### get_call_details
Get call technical details

### list_contacts
List Aircall contacts

### search_contacts
Search contacts by phone

### create_contact
Add a new contact

### list_users
List team members

### get_user_details
Get user availability

### list_numbers
List phone numbers

### get_number_details
Get number configuration

### list_teams
List Aircall teams

## 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?
```

## 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.