# CloudTalk MCP for AI Agents AI Agent Connect

> CloudTalk MCP lets your AI agent manage phone systems, handle contacts, and pull call logs. It connects your agent to your sales and support team's communication hub, making it easy to automate call center tasks like updating customer info or checking agent status without manual switching.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_4MXOgGwe3Kuz1h0mJFo3q9tpEqgW6Qxa3OtQZoXT/ai-agent-connect
- **Tags:** call-center, telephony, call-logs, crm-integration, business-communication, analytics

## Description

CloudTalk lets your AI client take over the heavy lifting of managing a phone system for your sales or support teams. Instead of jumping between tabs to find a customer's number or checking who's on a call, your agent can do it directly. You can have your agent pull up call logs to see what happened on a previous interaction or update a contact's details immediately after a conversation ends. It handles the tedious parts of CRM management by creating new entries or deleting old ones based on your instructions. Since it connects to your actual phone system, it can even initiate calls between agents and destination numbers. Using this Connector through the Vinkius catalog means your agent becomes a functional part of your communication stack, handling the data side of telephony so you can focus on the actual conversations.

## Tools

### create_contact
Add a new person to your system using just a name or email. This keeps your database updated as you meet new leads.

### delete_contact
Permanently remove a contact and all their linked data. Use this to keep your records clean and relevant.

### get_contact
Pull all the specific details for a single person in your database. It helps you prepare for a call in seconds.

### list_agents
See a full list of all agents currently in your CloudTalk system. This helps you see who is available to take calls.

### list_calls
Get a history of calls filtered by the agent or the direction of the call. Use it to audit past interactions.

### list_contacts
Supports pagination and filtering by email or phone number.

Retrieve a list of contacts from CloudTalk

### update_contact
Change specific fields for an existing contact to keep your records current. It ensures your CRM stays accurate.

### make_call
Start a phone call between an agent and a specific destination number. Your agent can initiate the connection for you.

## Prompt Examples

**Prompt:** 
```
Show me the last 5 calls from the sales team.
```

**Response:** 
```
Here are the last 5 calls for the sales team:

| Agent | Direction | Duration | Status |
| :--- | :--- | :--- | :--- |
| Sarah M. | Outbound | 4m 32s | Completed |
| Mike R. | Inbound | 2m 15s | Completed |
| Sarah M. | Outbound | 1m 10s | Missed |
| Jen L. | Inbound | 5m 45s | Completed |
| Mike R. | Outbound | 3m 20s | Completed |
```

**Prompt:** 
```
Find the contact for john.doe@example.com.
```

**Response:** 
```
**Contact Found:**

*   **Name:** John Doe
*   **Email:** john.doe@example.com
*   **Phone:** +1-555-0199
*   **Company:** Acme Corp
*   **Last Interaction:** March 15, 2025 (3m 45s)
*   **Total Interactions:** 12
```

**Prompt:** 
```
Call +123456789 from my extension.
```

**Response:** 
```
I've initiated that call for you.

*   **To:** +123456789
*   **From:** Your Extension (ext. 204)
*   **Status:** Ringing
*   **Call ID:** call_8f3a2b

You'll get a notification as soon as the call connects.
```

## Capabilities

### Create new contacts
Add a new person to your system using just a name or email.

### Delete old contact records
Permanently remove a contact and all their linked data.

### Pull contact details
Get all the specific details for a single person in your database.

### Get agent lists
See a full list of all agents currently in your CloudTalk system.

### Fetch call history
Get a history of calls filtered by the agent or the direction of the call.

### Initiate phone calls
Start a phone call between an agent and a specific destination number.

### Update contact fields
Change specific fields for an existing contact to keep your records current.

## Use Cases

### Handling a customer complaint
A customer calls in angry. You ask your agent to use get_contact to see their history. It finds 12 past interactions, helping you stay calm and informed.

### Post-call CRM cleanup
After a long sales call, you tell your agent to use update_contact. It adds the new phone number and the notes you just took to the record.

### Checking agent status
A manager needs to know who's free. They ask the agent to use list_agents to see a live list of available staff members.

### Quick lead entry
You just met someone at a booth. You tell your agent to use create_contact with their name and email to put them in the system immediately.

## Benefits

- Get real-time call history by using list_calls to see who has been reaching out and what they said.
- Keep your CRM clean by using update_contact to modify customer details the moment a call ends.
- Save time on data entry by using create_contact to add new leads directly through your agent.
- Monitor your team's availability instantly with list_agents to see who is ready to take calls.
- Pull specific customer data with get_contact to prepare for a conversation without hunting through tabs.
- Automate outbound outreach by using make_call to initiate conversations between your team and clients.

## How It Works

The bottom line is your agent handles the data entry and lookups so you can stay on the phone.

1. Connect your CloudTalk account to your AI client via Vinkius.
2. Give your agent permission to access your call logs and contact list.
3. Ask your agent to perform tasks like finding a customer or pulling call history.

## Frequently Asked Questions

**Can CloudTalk MCP help me update my CRM?**
Yes, it lets your agent update contact fields directly so your records stay current without manual typing.

**Can I see my call history with CloudTalk MCP?**
You can ask your agent to pull logs filtered by agent or direction to see exactly what happened.

**How does CloudTalk MCP handle new leads?**
Your agent can create new contacts using just a name or email to get them into your system fast.

**Can my agent actually make phone calls?**
Yes, it can initiate calls between your agents and destination numbers when you give it the info.

**Is CloudTalk MCP good for support teams?**
It's great for support because it lets your agent grab customer history instantly to speed up troubleshooting.

**Can I see who is online with CloudTalk MCP?**
You can use the agent to list all your active agents to see who is available to take a call.

**How do I find my CloudTalk API credentials?**
You can find your API Access Key ID and Secret in the CloudTalk Dashboard under Account > Settings > API keys.

**Can I record calls with this Connector?**
While the server doesn't initiate recording itself, it can retrieve links to call recordings if they were enabled in your CloudTalk settings.

**Which numbers can I use for making calls?**
You can use any of your verified CloudTalk numbers as the sender and any valid international phone number as the recipient.

**Can I record calls with this MCP server?**
While the server doesn't initiate recording itself, it can retrieve links to call recordings if they were enabled in your CloudTalk settings.