Freshcaller MCP. Manage call data and agents without leaving your chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Freshcaller MCP Server lets your AI client manage your cloud phone system. You can track call logs, check agent availability, and get recordings—all from natural conversation.
Use the Model Context Protocol to monitor call center metrics, manage numbers, and see who's on the line without logging into the dashboard.
What your AI agents can do
Get agent details
Retrieves specific metadata for a single agent.
Get call details
Retrieves detailed metadata about a specific phone call.
Get call recording
Gets a direct, secure link to a call's recording.
List recent calls and retrieve their metadata (duration, status) to understand call flow.
Check the status of specific agents and list all active teams to know who is available to take calls.
Fetch secure links to call recordings, making quality assurance and training material instantly available.
Retrieve real-time metrics on call volumes and service levels across your entire organization.
List owned numbers or search for new, available numbers to expand your global reach.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Freshcaller MCP Server: 12 Tools for Call & Agent Metrics
Use these tools to manage call logs, check agent status, track performance metrics, and handle number inventory directly through your AI client.
019d75a0get agent details
Retrieves specific metadata for a single agent.
019d75a0get call details
Retrieves detailed metadata about a specific phone call.
019d75a0get call recording
Gets a direct, secure link to a call's recording.
019d75a0get export status
Checks the current status of a data export job.
019d75a0get team details
Retrieves metadata about a specific agent team.
019d75a0list account metrics
Fetches current call center performance metrics.
019d75a0list agent teams
Lists all configured agent teams within the system.
019d75a0list agents
Lists all available call center agents and their current status.
019d75a0list buyable numbers
Searches for new phone numbers that you can buy and assign.
019d75a0list calls
Lists a filtered list of recent inbound and outbound phone calls.
019d75a0list export jobs
Lists all initiated and pending data export jobs.
019d75a0list my numbers
Lists all phone numbers currently owned by your account.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Freshcaller, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Freshcaller MCP Server lets your AI client handle your cloud phone system. You'll track call logs, check agent availability, and grab recordings—all without logging into a dashboard. Your agent uses the Model Context Protocol to manage numbers, check call center metrics, and see who's on the line, period.
To check call history and details, your agent can run list_calls to get a filtered list of recent inbound and outbound calls, and then get_call_details to pull detailed metadata about any specific call, like its duration or status.
To monitor agent status and capacity, your agent can use list_agents to list all available agents and see their current status, or get_agent_details to pull specific metadata for one agent. You can also check agent teams using list_agent_teams to see all configured teams, or get_team_details for metadata about a specific team.
Need call recordings for quality assurance? Your agent grabs a secure link to a call's recording using get_call_recording.
For auditing account performance metrics, your agent fetches real-time data on call volumes and service levels with list_account_metrics.
To inventory and scale phone numbers, your agent can run list_my_numbers to see all numbers you currently own, or list_buyable_numbers to search for new numbers you can buy and assign.
To manage data exports, your agent lists all initiated and pending jobs with list_export_jobs, and can check the status of a specific job using get_export_status.
How Freshcaller MCP Works
- 1 Subscribe to the server on the Vinkius Marketplace and enter your Freshcaller Domain and API Key.
- 2 Connect your preferred AI client (Claude, Cursor, etc.) to the Freshcaller MCP server.
- 3 Use natural language prompts, like 'Show me the status of the support team' or 'List my last 5 calls', and your agent handles the data retrieval.
The bottom line is, you manage your entire call center from your chat window, not from a dedicated dashboard.
Who Is Freshcaller MCP For?
This is for Support Managers and Operations Engineers who are tired of jumping between the dashboard, the spreadsheet, and the team chat just to get a simple answer. If you need a real-time overview of call center metrics or need to quickly verify an agent's availability, this tool saves you hours of manual clicking.
Quickly check missed call counts, list agent statuses, or retrieve recording links without navigating complex dashboards.
Get a real-time overview of call center metrics and call recording links using simple AI commands, keeping records accessible for post-call review.
Track outbound call history and verify call durations to generate accurate reports for lead engagement and commission tracking.
What Changes When You Connect
- See who's available right now with
list_agents. Instead of opening the agent roster dashboard, you just ask your agent, and it tells you exactly how many agents are 'Online' or 'On Call'. - Get immediate access to call recordings using
get_call_recording. For QA or training, you don't need to find the call in a separate records management system; your agent fetches the secure link for you. - Keep track of call volume trends using
list_account_metrics. You can ask for real-time metrics, helping you compare current call rates against last month's average in seconds. - Scale your presence globally. Use
list_buyable_numbersto search for new phone numbers andlist_my_numbersto audit your existing inventory, all from a single prompt. - Deep dive into call logs using
list_calls. You can list the last 10 calls and get metadata—like duration and status—to quickly verify if a lead call was completed or abandoned. - Streamline reporting by checking job status with
get_export_statusor listing jobs withlist_export_jobs. You confirm data exports are ready for analysis without logging into the reporting portal.
Real-World Use Cases
Verifying Lead Status After a Call
A sales rep needs to know the outcome of a call made last week. They prompt the agent: 'List my 5 most recent calls.' The agent uses list_calls and returns the call metadata, confirming the duration and direction (inbound/outbound) so the rep can update the CRM immediately.
Training a New Support Agent
A manager wants to review a tricky interaction. They prompt the agent: 'Get the recording link for call ABC123.' The agent uses get_call_recording and provides the secure link directly, letting the manager skip the manual search process.
Checking Team Availability Before a Campaign
The operations lead needs to know if the Tier 2 support team is ready for a marketing push. They prompt the agent: 'List agent teams and list agents in the support department.' The agent uses list_agent_teams and list_agents to give a real-time count of available staff.
Analyzing Call Center Health
The VP of Support needs a quick snapshot of service health. They prompt the agent: 'What are the current account metrics?' The agent runs list_account_metrics and returns the live data on call volumes and service level agreements, making the overview instant.
The Tradeoffs
Using spreadsheets for call data
Trying to build a master call log by manually logging details (date, duration, status) from the Freshcaller dashboard into a Google Sheet. This is slow, prone to human error, and never reflects the real-time status.
→
Instead, prompt the agent: 'List my last 10 calls.' The agent uses list_calls to pull the data directly from Freshcaller's API, giving you accurate, structured data instantly.
Checking agent status via phone calls
Calling a team member or checking their status via Slack to see if they're free for a meeting. This is unreliable and doesn't reflect actual call center availability.
→
Ask the agent: 'Show me the status of the Tier 2 team.' The agent uses list_agents to get the live, accurate status of every agent, whether they are online or on a call.
Searching for numbers manually
Logging into the portal just to see if you have an available number in a new region, requiring multiple clicks and potentially missing available inventory.
→
Ask the agent: 'Search for new phone numbers in London.' The agent uses list_buyable_numbers to check available inventory immediately, letting you plan your global expansion.
When It Fits, When It Doesn't
Use this server if your job requires synthesizing operational data across multiple systems—specifically, if you need to correlate call metrics with agent status or pull recordings for QA. This is for operational roles (Support Managers, Ops Leads) who need fast, structured data access.
Don't use this if you just need to write a simple status report or manage basic user records. For those tasks, a dedicated internal CRM or HR system is better. If you only need to track which agent was assigned, but not their current availability, you might only need get_agent_details without the full server.
Remember, this server is a data retrieval layer. It gets the data; you still have to run the analysis. If you need to predict churn or score calls, you'll need to pass the retrieved data to a separate analytics platform.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Freshcaller. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 12 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Pulling call data shouldn't require logging into a dashboard.
Today, checking a team's performance means opening the Freshcaller dashboard, clicking into 'Reporting,' filtering by date range, and then manually copying call counts or agent statuses into a shared document. It's a frustrating, multi-step process that slows down decision-making.
With this MCP server, you just ask your agent: 'What were the call volumes last week?' Your agent uses `list_account_metrics` and spits out the numbers you need instantly. You get the data, not a screenshot.
Freshcaller MCP Server: Monitor calls and agents instantly.
Before, getting a recording link for a specific call meant navigating deep into the call history, finding the correct call ID, and then manually generating the secure link. It was a three-to-four click chore.
Now, you simply prompt the agent: 'Get the recording link for call XYZ.' The agent uses `get_call_recording` and delivers the link directly. The time saved is immediate and measurable.
Common Questions About Freshcaller MCP
How do I get an API Key for Freshcaller? +
Log in to Freshcaller, click on your Profile Icon, then go to Profile Settings to find your API Key.
Where do I find my Freshcaller Domain? +
Your domain is the subdomain in your Freshcaller URL (e.g. if your URL is 'acme.freshcaller.com', your domain is 'acme').
Can I listen to call recordings through the agent? +
Yes! Use the 'get_call_recording' tool and provide the Call ID. The agent will return a secure link to the recording file.
Is it possible to see which agents are currently available? +
Yes, the 'list_agents' tool retrieves all users in your account along with their current status and metadata.
How do I use the `list_calls` tool to filter calls by date range? +
You can specify date parameters when calling list_calls. Just include the start and end dates in your request to narrow down the results. This lets you pull call logs for a specific reporting period.
What kind of metadata can I get using the `get_call_details` tool? +
The get_call_details tool provides comprehensive metadata for any call. This includes the call duration, the connection status, and whether the call was inbound or outbound.
Does the `list_agents` tool show agents who are currently 'on call'? +
Yes, the list_agents tool includes the real-time status of your agents. You'll see if they are 'Online', 'On Call', or 'Offline' in the results.
How do I check if a phone number is available using `list_buyable_numbers`? +
The list_buyable_numbers tool searches your inventory for available numbers. It returns a list of numbers you can acquire to expand your global phone presence.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Rocketlane
Deliver customer onboarding projects on time with collaborative workspaces, task tracking, and time-to-value analytics.
Clickatell
Deliver transactional and marketing messages over SMS, WhatsApp, and chat channels with global reach and high deliverability.
Bazaarvoice
Analyze and manage user-generated content via Bazaarvoice — list products, reviews, and customer questions directly from any AI agent.
You might also like
FusionSignage
Control digital signage screens remotely with content scheduling, playlist management, and real-time display monitoring.
Envi Healthcare Supply Chain
Equip your AI agent to manage healthcare purchase orders, track medical inventory, and monitor vendors via the Envi API.
Automate Reddit interactions via AI — search subreddits, list hot posts, and retrieve comment threads directly.