# Channels MCP MCP > Channels MCP manages all your customer communications—live chat, phone calls, and contact records—through natural conversation. It lets you track every interaction, fetch call recordings for review, update customer profiles instantly, and manage system webhooks without touching a dashboard. Get full control over your cloud telephony workflows directly from your agent. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** cloud-phone, call-tracking, live-chat, customer-data, omnichannel, real-time-support ## Description This MCP connects your entire communications stack to your AI client. Instead of opening the Channels app to manually log data or dig through fragmented phone records, your agent handles it all. You can ask for a summary of team performance by retrieving aggregate call statistics, or you can simply prompt it to fetch a specific customer’s full profile metadata and history in one go. The system lets you manage everything from creating new contact records to setting up real-time webhooks for operational reporting. Because this MCP is hosted on Vinkius, your agent connects once and gains access to all these powerful telephony tools—you don't need separate API keys or logins for each function. It’s essentially turning a complex communications platform into simple natural language commands. ## Tools ### create_contact Adds a brand new customer record to the system directory. ### create_webhook Sets up a custom web hook endpoint for real-time event notifications. ### delete_contact Permanently removes an existing customer record from the directory. ### get_account_info Retrieves general details about the entire connected account structure. ### get_call_recording Generates a secure, temporary link to download an audio file of a past call. ### get_contact Fetches the full profile details for one specific customer by name or ID. ### get_call_stats Calculates and returns aggregate statistics about team calling performance over a specified period. ### list_calls Retrieves a list of recent call interactions, including outcomes and duration. ### list_contacts Returns a full list of all currently synced customer contacts in the directory. ### list_users Lists every user account configured within your organization for call routing purposes. ### list_webhooks Shows all currently active and configured web hooks attached to the system. ### update_contact Modifies specific data fields on an existing customer profile record. ## Prompt Examples **Prompt:** ``` List all my customer contacts in Channels. ``` **Response:** ``` I've retrieved your contact directory. You currently have 150 synced contacts, including 'Alice Brown' and 'TechCorp Support'. Would you like the full profile for a specific person? ``` **Prompt:** ``` Show the last 5 calls and their duration. ``` **Response:** ``` Accessing call logs... Your last 5 interactions include 3 answered calls (avg duration: 4m 30s) and 2 missed. The most recent was an outgoing call to @user1. Shall I retrieve the recording for the longest call? ``` **Prompt:** ``` Get the recording for call ID 'call_789'. ``` **Response:** ``` Link generated! You can download the audio for call_789 here: [recording_url]. The link is secure and will expire in 24 hours. Need a summary of the call statistics? ``` ## Capabilities ### Manage Customer Records Create, read, update, and delete customer profiles using the contact directory. ### Analyze Call History Retrieve detailed call statistics, list recent calls, or fetch high-fidelity recordings for past interactions. ### Coordinate Team Access Access the internal directory of organization users to plan and route calls through your agent. ### Automate System Events Configure and monitor real-time webhooks for call events, ensuring instant operational reporting. ## Use Cases ### Customer support agent needs historical data. A customer calls about an issue from three months ago. Instead of asking the customer for their account number, the Support Agent asks the MCP to use `get_contact` and immediately pulls up the full profile and last five interactions so they can solve the problem in minutes. ### Operations team needs daily performance review. The Ops Manager doesn't want to manually compile call reports. They ask the agent to run `get_call_stats` for the last quarter, getting aggregated data on average handle time and total missed calls in seconds. ### Developer needs a custom system alert. A developer wants an instant notification when a critical contact record is modified. They use the MCP to list webhooks (`list_webhooks`) and then create a new one using `create_webhook` for automated alerts. ### Sales team needs to clean up old data. A user finds an outdated or redundant contact entry. They ask the agent to use `get_contact` first, verify the details, and then execute `delete_contact` safely, ensuring no critical information is accidentally lost. ## Benefits - Stop manual logging. Instead of copying call results into a spreadsheet, use the agent to summarize performance by calling `get_call_stats` directly. You get instant insights without leaving your workspace. - Context is king. Need details on a caller? Just ask for their profile; the MCP will execute `get_contact` and give you the full history—no switching tabs needed. - Full audit trail access. Whenever a key call happens, use `list_calls` to see immediate outcomes, or request a specific recording URL via `get_call_recording` for follow-up. - Zero setup time for integrations. Instead of writing boilerplate code for every event, you just configure and manage webhooks using the MCP's tools. - Centralized user management. You don't have to guess who is on call; use `list_users` to verify team roles and ensure proper routing before a conversation even starts. ## How It Works The bottom line is, you get full control over complex call logic and customer data by simply asking your agent conversational questions. 1. First, subscribe to this MCP on Vinkius and grab your API Key and Account ID from the Channels Developer tab. 2. Next, tell your AI client what you need—for example, 'Get all contacts who called yesterday' or 'Create a new contact for John Doe'. 3. Your agent executes the necessary functions against the platform and returns the structured data directly to your conversation. ## Frequently Asked Questions **How do I get call statistics using the Channels MCP?** You use `get_call_stats`. This tool calculates and returns aggregate performance metrics for your team, allowing you to track total calls, average duration, and other key indicators easily. **Can I update a contact using the Channels MCP?** Yes. You use `update_contact` by providing the necessary ID and the new data payload, ensuring that existing customer records are kept accurate without manual entry. **What if I need to delete an old record?** You run `delete_contact`. This tool permanently removes a specified contact from your directory. Always verify the details first using `get_contact` before executing this command. **How do I set up webhooks with Channels MCP?** You start by calling `create_webhook`. The agent handles the creation and configuration of the endpoint, so your application gets notified instantly when a specific call event occurs. **How do I retrieve basic account information using the `get_account_info` tool?** You must use `get_account_info` to confirm connectivity. This tool retrieves your core account details, including metadata needed for all subsequent operations like managing contacts or running reports. **Which tool should I use to check the directory of users in my organization using `list_users`?** Run `list_users`. This fetches a comprehensive list of every user associated with your account. You can then coordinate call routing or troubleshoot access issues using this team directory. **After running `list_contacts`, what tool do I use to get the complete details for a specific customer record? ** Use the `get_contact` tool. Providing a unique contact ID allows your agent to return high-fidelity profile metadata, giving you far more detail than just the basic listing. **How can I view a log of my most recent communication attempts using `list_calls`?** Simply call `list_calls`. This action retrieves a history of your last interactions, showing if calls were answered or missed, along with the crucial timestamps for quick operational review. **How do I find my Channels API Key and Account ID?** Log in to your account, click on your profile menu, go to the **Developer** tab, and you will see your API Key and Account ID. **Can I listen to call recordings via AI?** Yes! The `get_call_recording` tool generates a temporary secure download link for any recorded call in your history. **How do I create a new contact programmatically?** Use the `create_contact` tool and provide the customer's name and phone number (in E.164 format).