# Kavkom MCP MCP > Kavkom MCP connects your AI client to a professional cloud phone system, giving you full control over communications management through natural conversation. You can pull up call history, review voicemails with transcripts, check SMS logs, and manage contacts—all without switching screens. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** cloud-telephony, ivr, call-routing, voicemail, call-analytics, contact-database ## Description Your agent lets you talk directly to your company's phone system. Instead of logging into a separate CRM dashboard or digging through multiple tabs just to see what happened last week, you ask for it. It pulls together the full context: who you called, when you texted them, and if there was any activity on their voicemail. You can manage contacts directly, ensuring that new leads get captured immediately. This makes sure your team always has a single view of every customer interaction—voice calls, texts, and internal notes. If you're looking for a way to connect communication infrastructure to AI workflows, check out the full catalog at Vinkius; this MCP is one part of what's possible. It gives support agents instant access to call recordings and detailed logs, letting them solve problems faster. Managers can monitor team usage by checking available phone lines or auditing performance trends from historical data. ## Tools ### create_contact Adds a new person to your address book. ### get_call_details Retrieves specific information about one particular phone call. ### list_calls Shows a history of all calls made or received through the system. ### list_crm_contacts Retrieves a list of contacts synced from your main CRM record. ### list_sms_history Lists all sent and received text messages through the platform. ### list_team_members Gets a list of every user account tied to your Kavkom service. ### send_sms_message Sends an outbound 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 ### Review Call History The MCP retrieves a full list of past calls, detailing who was called, when, and the duration. ### Access Customer Details You can pull up contact records, including synced data from your CRM, to get background context on any lead or client. ### Manage Team Users The MCP lists all active users and phone lines assigned within the account so you know who handles which numbers. ### Send Text Messages You can initiate outbound text messages to a contact right from your agent's conversation flow. ### Get Specific Call Records It pulls granular details for one specific call, including status and duration. ## Use Cases ### Customer Service follow-up A support agent needs to know why a client called three weeks ago. They prompt their agent, and it uses `list_calls` and then `get_call_details` to pull up the specific record, along with any associated voicemail transcripts, so they can address the issue immediately. ### New Lead Qualification A sales rep meets a prospect. They use `list_crm_contacts` first to see if the company is already in the system. If not, they use `create_contact`. Then, they send an introductory text using `send_sms_message`, keeping all activity logged. ### Performance Audit The manager needs to know if two specific team members are overusing a certain line. They prompt the agent, which uses `list_calls` and `list_team_members` to compare usage metrics across assigned phone lines. ### Cross-Channel Context Gathering A user needs all communication history on a client, regardless of channel. The agent pulls data using `list_sms_history`, then cross-references it with the primary contact record via `list_crm_contacts`. ## Benefits - Stop switching between your phone logs and CRM tabs. You get the combined context—calls, texts, contacts—in one prompt by calling `list_crm_contacts` and other history tools. - Never miss a detail. Review call recordings or listen to voicemails with transcripts right through your agent. This is faster than manually pulling reports. - Build new leads instantly. If someone mentions a potential client, you can use `create_contact` immediately, capturing the data without leaving your current workflow. - Keep track of who's available. Need to know which line belongs to which person? Use `list_team_members` to audit your team's phone setup quickly. - Handle outreach efficiently. If a client isn't answering their main number, you can use `send_sms_message` directly from the MCP conversation. ## How It Works The bottom line is you get full phone system access through conversation, without needing to log into a separate portal. 1. First, subscribe to the Kavkom MCP on Vinkius. 2. Second, provide your unique Kavkom API Token when prompted. 3. Third, use natural language prompts within Claude, Cursor, or any MCP-compatible client to start managing communications. ## Frequently Asked Questions **How do I check a client's full call history using list_calls?** Use `list_calls` to see all activity over a period. This tool returns the date, duration, and direction of every recorded phone interaction. **Can Kavkom MCP send texts outside of an agent prompt?** No; you must use your AI client's chat interface to trigger `send_sms_message`. The tool is designed for agent-driven workflows. **What if I need to add a new contact? Do I use create_contact?** Yes, that’s the right tool. Calling `create_contact` ensures that any newly mentioned lead gets immediately logged into your system's database. **Does list_crm_contacts show both calls and SMS messages?** It pulls a unified view of contacts synced from the CRM. This helps consolidate data from various sources, including call logs and text message records. **If I need to audit who has access, how do I use the list_team_members tool?** It lists every account user currently linked to your Kavkom subscription. This is key for security audits; you can quickly identify which team members have access credentials. **When I get call details using get_call_details, what specific information does the record contain?** It provides more than just duration. You'll receive the caller ID, connection status, and sometimes full transcripts attached to the specific call instance. **When running list_calls, can I filter the history by a date range or specific outcome?** Yes, you pass parameters for time and status. This is crucial because it narrows down results immediately, preventing your agent from downloading unnecessary data. **If I use list_sms_history to review messages, does the MCP handle rate limits or high volume retrieval?** The API manages large volumes by processing them in batches. If you hit a daily sending threshold, your agent will receive an error code indicating that rate limit breach. **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.