# CloudTalk MCP for AI Agents MCP > CloudTalk lets your AI agents automate core call center functions. It connects directly to phone system data, allowing you to manage contacts, track detailed call histories, and initiate calls programmatically for sales or support teams. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** call-center, telephony, call-logs, crm-integration, business-communication, analytics ## Description This MCP gives your agent control over a modern cloud-based phone system, making it ideal for any high-volume sales or customer support operation. Instead of having agents manually log every interaction into multiple spreadsheets, the AI client pulls all that data automatically. It lets you search through extensive contact lists to find specific clients, update their records when they change jobs, and even initiate outbound calls directly from your workflow. Need to audit performance? The agent can pull comprehensive call logs, filtering by time or agent name. For full visibility into your operation, the Vinkius catalog connects this entire system into one place, letting you access contact management alongside detailed analytics in a single conversational flow. You finally get an automated view of who called whom, when they spoke, and what the outcome was. ## Tools ### create_contact Creates a new contact record in CloudTalk, requiring at least a name or email address. ### delete_contact Permanently removes a specified contact and all associated data from the system. ### get_contact Retrieves detailed information for one specific contact using their identifying details. ### list_agents Pulls a complete list of all active agents currently registered in CloudTalk. ### list_calls Generates a comprehensive log of calls, which can be filtered by the agent involved or call direction (inbound/outbound). ### list_contacts Retrieves a list of contacts, supporting pagination and filtering by email or phone number. ### make_call Initiates an outgoing phone call from the agent's extension to a specified destination number. ### update_contact Modifies existing contact records, allowing you to update any field using the known contact ID. ## Prompt Examples **Prompt:** ``` What were the last five calls to support from California? ``` **Response:** ``` **Call Log Summary: Last 5 Calls (CA Region)** * **2026-06-12:** +1 (415) 555-9876 -> Support Team. Status: Completed (Talk Time: 8m). Agent: Sarah M. * **2026-06-12:** +1 (415) 555-1234 -> Sales Team. Status: Missed. Ring attempts: 3. * **2026-06-11:** +1 (415) 555-9876 -> Support Team. Status: Completed (Talk Time: 3m). Agent: Tom B. Total calls reviewed: 5. ``` **Prompt:** ``` I need to add a new lead for 'Global Dynamics' with this email and phone number. ``` **Response:** ``` **New Contact Created Successfully!** * **Name:** Global Dynamics Inc. * **Email:** contact@globaldynamics.com * **Phone:** +1-202-555-8888 * **Status:** Active A record was created and is now available for use in call logs. ``` **Prompt:** ``` Can you check the full details on John Doe, specifically his total interactions? ``` **Response:** ``` **Contact Profile: John Doe** * **Company:** Acme Corp. * **Main Phone:** +1-555-0199 * **Agent Assigned:** Sarah M. * **Total Interactions:** 12 (Last call was March 15, 2025). He's a high-touch client; remember to check his last activity before calling. ``` ## Capabilities ### Manage Customer Records Create new client contacts or modify existing details like phone numbers and company names. ### Retrieve Contact Details Fetch specific, detailed information about any contact using their email or name. ### List All Contacts Pull a paginated list of contacts, allowing you to filter by phone number or email address. ### Initiate Phone Calls Programmatically start an outgoing call between your agent's extension and any destination number. ### Access Call History Retrieve a filtered list of completed, missed, or ringing calls for review. ### List Available Agents Get a roster of active agents within the cloud phone system. ## Use Cases ### Auditing a Client's Interaction History A manager needs to see if a client was recently contacted. They ask their agent, 'Show me all calls for Acme Corp.' The agent uses list_calls and get_contact to pull up the last three interactions, including dates and talk times. ### Handling a New Lead's Data A sales rep gets a lead via email. Instead of opening a browser tab, they ask their agent to 'create a new contact for this person.' The agent uses create_contact, logging the name and phone number instantly. ### Following Up on an Old Account A support specialist needs to check if the customer's email address has changed. They use list_contacts to search by old data, then use get_contact to retrieve the updated record and confirm the new details. ### Running Daily Performance Reports At end-of-day wrap-up, a supervisor asks their agent to 'list all calls made today by Sarah M.' The agent uses list_calls to generate a summary of completed and missed connections. ## Benefits - Stop manual data entry. Instead of copying call details into a separate sheet, let the agent pull accurate records using list_calls or list_contacts. - Improve customer experience by instantly fetching full client histories. Use get_contact to retrieve everything you need about a person in seconds. - Boost sales efficiency. Your agent can initiate calls directly via make_call when it's time for a follow-up, without needing manual dialer access. - Maintain clean data. Easily update or delete records using update_contact and delete_contact, keeping your CRM accurate for future use. - Audit performance quickly. Run reports on agent activity by listing all agents or reviewing the full call log history with list_calls. ## How It Works The bottom line is that instead of navigating complex dashboards, your AI client runs these operations using natural language requests. 1. You ask your agent to perform an action, like 'find all calls from last week' or 'create a new contact for Jane Doe.' 2. The AI client uses this MCP to call the relevant tool (like list_calls or create_contact), sending it only the necessary parameters. 3. The system executes the command against CloudTalk and returns structured data, which your agent then formats into a simple report for you. ## Frequently Asked Questions **How do I use the CloudTalk MCP to find customer contact info?** You can ask your agent to list or retrieve specific contacts using their name, email, or phone number. The tool pulls all necessary details from CloudTalk so you don't have to switch screens. **Does the CloudTalk MCP help me track call center activity?** Yes, it gives you detailed access to calling logs. You can ask for filtered lists of calls, letting you review missed connections or total talk time over any given period. **What if I need to update a client's phone number?** You simply tell your agent which contact needs fixing and what the new details are. The tool updates the record directly in CloudTalk, keeping your data current automatically. **Can I make outbound calls using CloudTalk MCP?** Yes, you can instruct your agent to initiate a call from your extension to any number. This is great for follow-ups or quick check-ins without lifting a finger. **Is the CloudTalk MCP better than just using my phone system's built-in report?** The MCP aggregates that data and makes it conversational. Instead of downloading and filtering a PDF, you get an immediate summary and structured action items right in your chat window. **What kind of reports can I run with CloudTalk MCP?** You can generate comprehensive reports on agent performance by listing all calls, which gives metrics like talk time, status (completed/missed), and the associated agents.