# Freshcaller MCP > Freshcaller connects your cloud phone system to any AI client. Use this MCP to automate contact center management by asking natural questions about calls and agents. You can track call logs, get performance metrics, list owned numbers, or retrieve recordings—all without opening a dashboard. It puts the entire operational data of your global phone setup right into conversation. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** cloud-telephony, call-tracking, contact-center, agent-management, call-recordings, performance-metrics ## Description Managing a cloud phone system used to mean clicking through endless dashboards just to find out basic information. This MCP changes that. By connecting Freshcaller to any AI client, you can handle complex contact center operations simply by talking to your agent. Need to know how many calls were missed last week? Just ask. Want the link to a specific customer service recording for training? You get it instantly. It’s built on Vinkius, the #1 MCP Catalog, so once you connect, all your AI clients—Claude, Cursor, and others—can access this data through one place. Your agent can list all agents online, check team routing rules, or even find available phone numbers to expand your global reach. You get real-time operational oversight without ever leaving the chat window. ## Tools ### get_call_details Retrieves specific metadata about a single phone call. ### get_export_status Checks the status of any data export job you initiated. ### get_call_recording Fetches a secure link to an archived phone call recording. ### get_team_details Retrieves metadata about a specific agent team configuration. ### get_agent_details Gets the status and details for an individual call center agent. ### list_buyable_numbers Searches and lists phone numbers that are currently available to purchase. ### list_calls Provides a list of your most recent incoming and outgoing calls. ### list_export_jobs Shows a comprehensive list of all initiated data export jobs. ### list_account_metrics Retrieves key operational metrics for your entire call center account. ### list_my_numbers Lists all the phone numbers you currently own and use. ### list_agent_teams Displays a list of all configured agent teams within your system. ### list_agents Provides a roster of all available call center agents and their current status. ## Prompt Examples **Prompt:** ``` List my 5 most recent calls and their duration. ``` **Response:** ``` Retrieving calls... I found 5 recent entries, including an inbound call from '+1234567890' (Duration: 120s) and an outbound call to '+10987654321' (Duration: 45s). ``` **Prompt:** ``` Show me the status of all agents in my support team. ``` **Response:** ``` Fetching agents... In your support team, 3 agents are 'Online' (John, Sarah, Mike), 1 is 'On Call' (Emma), and 2 are 'Offline'. ``` **Prompt:** ``` Get the recording link for call 'call_abc123'. ``` **Response:** ``` Retrieving recording... I've successfully fetched the secure recording link for call 'call_abc123'. You can access it here: [Recording Link]. ``` ## Capabilities ### Analyze call activity List recent inbound and outbound calls and pull detailed information like duration and status. ### Manage team resources View the current status of all agents, list configured teams, or check if a specific agent is online. ### Retrieve call recordings Get direct, secure links to actual call recordings for quality assurance and staff training. ### Monitor service metrics Access real-time account data showing overall call volumes and service level performance across the company. ### Inventory phone numbers List all currently owned phone numbers or search for new, available local numbers to scale your operations. ## Use Cases ### Investigating a missed opportunity A Sales Director needs to know if their team followed up on leads from last week. They ask the agent to `list_calls` for the past seven days, check the status of specific agents using `get_agent_details`, and then retrieve any relevant recordings via `get_call_recording` to verify the conversation. ### Quarterly performance review prep A Support Manager needs metrics for a board presentation. Instead of logging into three separate dashboards, they ask the agent to run `list_account_metrics` and also use `list_export_jobs` to verify that historical data is ready for deep analysis. ### Scaling up to a new region The Ops Lead needs to add service numbers in France. They ask the agent to run `list_buyable_numbers`, which provides immediate options, and then they use `list_my_numbers` to confirm what is already owned. ### Checking team readiness A Team Coordinator needs to know if the Tier 2 support team can handle an unexpected surge in calls. They ask for `get_team_details` and then cross-reference that information with a list of active agents using `list_agents`. ## Benefits - Instantly check operational statuses. Instead of manually navigating to the agent dashboard, you can ask your AI client for the current status of all team members or list specific agents using `list_agents`. - Deep dive into call history without clicking through dozens of logs. You can use `list_calls` to get a summary of recent activity and immediately check details on any entry using `get_call_details`. - Never lose context for training or disputes. When you need proof of what was said, simply ask the agent to fetch the recording link with `get_call_recording`. - Scale your global presence without delay. You can use `list_buyable_numbers` to search and find available phone numbers immediately when a new market opens up. - Understand performance at a glance. Pulling high-level call volumes and service level data using `list_account_metrics` lets you run reports faster than any manual spreadsheet compilation. ## How It Works The bottom line is you talk to your agent, and it pulls the necessary call center data from Freshcaller directly. 1. Subscribe to this MCP through the Vinkius Marketplace. 2. Enter your Freshcaller Domain and API Key (you find these in your profile settings). 3. Start asking questions about your contact center data using Claude, Cursor, or any compatible AI client. ## Frequently Asked Questions **How do I check call metrics with the Freshcaller MCP?** You use the `list_account_metrics` tool. Simply ask your agent to retrieve this data, and it will pull real-time information on call volumes and service levels for you. **Can I find out which numbers are available using Freshcaller MCP?** Yes, use the `list_buyable_numbers` tool. This searches the system and provides a list of phone numbers that you can purchase to expand your service area. **What if I need recordings from an old call using Freshcaller MCP?** First, use `list_calls` to find the call's ID. Then, ask the agent to run `get_call_recording` with that specific ID to get the secure link. **Does the Freshcaller MCP help me monitor my agents?** Yes, you can use tools like `list_agents` and `get_agent_details`. This lets you see who is online, who is on call, and track team status instantly. **Is there a way to list all my owned numbers with Freshcaller MCP?** Use the `list_my_numbers` tool. It retrieves a full roster of every phone number currently associated with your account, helping you manage inventory easily.