# Kavkom MCP

> Kavkom MCP Server manages your cloud phone system. Use your AI agent to track calls, manage contacts, and handle messages through a single chat interface. You can list call history, review voicemails, send SMS, and manage team users without leaving your client.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** cloud-telephony, ivr, call-routing, voicemail, call-analytics, contact-database

## Description

**Kavkom MCP Server** lets your AI client track calls, manage contacts, and handle messages all in one spot. Your agent can pull call history, review voicemails, send texts, and manage team users without you having to leave your chat window. You'll use the `list_calls` tool to pull your call history, getting details like duration, direction, and status for every call. You can dive deeper into any specific call with `get_call_details`, which pulls up all the juicy info on a given call ID. To handle contacts, you'll get a synced list of leads from your CRM using `list_crm_contacts`, and you can quickly drop new leads into the system with `create_contact`. For messaging, you'll send a new SMS text message using `send_sms_message` or grab transcripts from voicemails to cover both voice and text interactions. You can see who's on the team by running `list_team_members`, and you'll check which phone lines are active and assigned using `list_phone_lines`. You'll also be able to access and review call recordings for deep post-call analysis.

## Tools

### create_contact
Adds a new contact record to the system.

### get_call_details
Retrieves detailed information for a specific call ID.

### list_calls
Lists the user's call history records.

### list_crm_contacts
Retrieves a list of contacts synced from the CRM.

### list_sms_history
Lists all sent and received SMS messages.

### list_team_members
Lists all active users on the Kavkom account.

### send_sms_message
Sends a new SMS text message to a specified number.

## Prompt Examples

**Prompt:** 
```
Show today's call log and any pending voicemails.
```

**Response:** 
```
Today: 22 calls. Inbound: 14 (avg 3.8 min). Outbound: 8 (avg 5.2 min). Missed: 3. Voicemails: 2 pending. 1) +33-1-4567-8901 (2 min, 10:30 AM): 'Calling about the proposal...' 2) +33-6-1234-5678 (1 min, 11:15 AM): 'Please call back regarding invoice.'
```

**Prompt:** 
```
List all contacts and the phone lines assigned to the team.
```

**Response:** 
```
Contacts: 156. Recent: Ana Costa (12 calls), James Lee (8 calls), Lisa Park (5 calls). Phone lines: 5 active. +33-1-4567-0001 (Main, Sarah). +33-1-4567-0002 (Support, Mike). +33-1-4567-0003 (Sales, Lisa). 2 unassigned.
```

**Prompt:** 
```
Show call recordings from this week for the sales line.
```

**Response:** 
```
Sales line (+33-1-4567-0003): 18 calls this week. Recordings: 15 available. Longest: 'Enterprise Deal' (22 min, Lisa). Total recording time: 3h 45m. Top contacts called: Acme Corp (5 calls), TechCo (3 calls).
```

## Capabilities

### Track Call Activity
Use `list_calls` and `get_call_details` to pull comprehensive records of calls, including duration, direction, and status.

### Manage Contacts and Leads
Use `list_crm_contacts` to pull synced contact lists, and `create_contact` to add new leads directly from your agent.

### Handle Multi-Channel Communication
Send messages using `send_sms_message` or retrieve transcripts from voicemails to cover both voice and text interactions.

### View Team & Line Status
Use `list_team_members` to audit account users, and `list_phone_lines` to check which lines are active and assigned.

### Review Call Recordings
Access and review call recordings for detailed post-call analysis.

## Use Cases

### Investigating a Missed Call
A customer calls, but the rep misses them. The rep asks their agent, 'What did we talk about last week?' The agent runs `list_calls` and pulls up the last conversation details. The rep then uses `list_crm_contacts` to find the client's account manager and sends a follow-up message using `send_sms_message`.

### Onboarding a New Sales Rep
The manager needs to check a new hire's activity. They ask the agent to list team members (`list_team_members`) and then pull the call history (`list_calls`) for a specific employee. This gives the manager an immediate, auditable view of the team's performance.

### Handling a Complex Support Ticket
A support agent needs full context. They ask the agent to pull all records: the call history (`list_calls`), the associated voicemail transcript, and the last text exchange (`list_sms_history`). The agent compiles all three data points for the agent to respond accurately.

### Preparing for a Large Client Meeting
Before the meeting, a PM asks the agent to list all synced contacts (`list_crm_contacts`) related to the client's industry. They then use `get_call_details` on the top 5 contacts to ensure the team knows the history for each person attending.

## Benefits

- You instantly see the full context before every call. Instead of manually checking a CRM dashboard, your AI agent uses `list_crm_contacts` and `list_calls` to summarize a contact's history for you.
- Your communications are centralized. You can manage both voice records and text messages. Use `list_sms_history` and review voicemail transcripts to get a complete picture of every interaction.
- Team oversight becomes simple. Use `list_team_members` to see who's on the account and use `list_calls` to monitor team usage metrics, all in one chat session.
- Never miss a lead. Use `create_contact` to capture new leads immediately after a call, ensuring the data goes straight into your central contact database.
- Analyze performance with deep data pulls. Your agent can run `get_call_details` for a specific call, giving you the exact duration, direction, and status needed for reporting.
- Audit your whole operation. You can pull all records—from `list_calls` to `list_sms_history`—to audit communication patterns across your entire team.

## How It Works

The bottom line is you manage all your phone and messaging data by talking to your AI agent, not by clicking through a web dashboard.

1. Subscribe to the Kavkom server and enter your unique Kavkom API Token.
2. Your AI client sends a natural language request (e.g., 'What were my calls yesterday?').
3. The agent invokes the appropriate tool (e.g., `list_calls`), and the server returns structured data that your agent uses to write a conversational answer.

## Frequently Asked Questions

**How do I use the `list_calls` tool with Kavkom MCP Server?**
The `list_calls` tool retrieves your call history records. You can ask your agent to filter this data by date range, call status (missed/inbound/outbound), or contact name for a quick summary.

**Does Kavkom MCP Server handle SMS messages?**
Yes. You can use `list_sms_history` to see all past texts sent and received, and `send_sms_message` to send new messages directly from your agent.

**Can I get details for a single call using Kavkom MCP Server?**
Use the `get_call_details` tool. You just need to provide the specific call ID, and the server returns all relevant details for that single interaction.

**How do I update a contact record using Kavkom MCP Server?**
The `create_contact` tool is used to add new contacts. If the contact already exists, you'll need to check the `list_crm_contacts` tool first to get the existing ID.

**Can I list all users on the Kavkom MCP Server?**
Yes, run `list_team_members`. This tool gives you a clear list of all active users who have access to the account.

**What is the purpose of the `list_crm_contacts` tool in the Kavkom MCP Server?**
This tool lists contacts synced from your CRM. It gives you a separate view of contacts that are connected to your business software, distinct from manually created records.

**How do I use the `create_contact` tool to add a new contact?**
You pass the required contact details, like name and phone number, directly to the `create_contact` tool. The server then registers the new contact in your system.

**Can I use the `list_sms_history` tool to see both incoming and outgoing messages?**
Yes, `list_sms_history` retrieves a comprehensive record of both sent and received SMS messages. It provides the full history of your text communications.

**Can I view call logs and recordings?**
Yes. Browse call history with filters for direction, duration, and status. Access call recordings with metadata for any logged call.

**Can I access voicemail messages?**
Yes. List voicemail messages with caller info, timestamps, and transcripts when available.

**Can I manage phone lines and their assignments?**
Yes. List all phone lines with their numbers, assignments, and status.