# Freshcaller MCP for AI Agents AI Agent Connect

> Freshcaller lets you manage your cloud phone system and contact center data using your AI agent. It connects to your Freshdesk Contact Center account so you can track calls, monitor agent performance, and pull recording links without leaving your chat interface.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_9o8YDnOCi8yb8bsQKsotU6ezif21Rw2f3LFNuPkd/ai-agent-connect
- **Tags:** cloud-telephony, call-tracking, contact-center, agent-management, call-recordings, performance-metrics

## Description

You spend a lot of time jumping between tabs to see if your agents are online or to find a specific call recording for a quality check. This Connector changes that by letting your AI agent handle the heavy lifting of contact center management. Instead of hunting through a dashboard, you can just ask your agent for the latest call metrics or to list the status of your support teams. It handles the data retrieval for your cloud telephony system so you can stay focused on the people you're helping. By connecting this through the Vinkius marketplace, you get a direct line to your phone system's data, making it way easier to oversee global operations or pull historical data for your reports.

## Tools

### get_call_details
Get the metadata for a specific phone call. Use this to see the duration and status of any individual call.

### get_team_details
Fetch metadata about your configured agent teams. Use this to understand how your routing groups are set up.

### get_export_status
Check the progress of your data export jobs. This helps you know when your historical records are ready for analysis.

### get_call_recording
Get a direct link to a specific call recording. This is perfect for quickly sharing audio with your team for training.

### get_agent_details
Retrieve specific metadata for individual agents. This gives you a clear look at who is handling your calls.

### list_buyable_numbers
Search for new phone numbers available for purchase. Use this to scale your contact center into new regions.

### list_calls
List your most recent inbound and outbound calls. This helps you quickly see the latest activity on your lines.

### list_export_jobs
View a list of all initiated data export jobs. Keep track of multiple requests to ensure your data is being processed.

### list_account_metrics
Get a summary of your call center metrics. This provides a high level view of your organization's service levels.

### list_my_numbers
List all phone numbers currently owned by your account. This helps you manage your existing telephony inventory.

### list_agent_teams
List all the agent teams in your system. Use this to get a bird's-eye view of your team structure.

### list_agents
List all agents in your contact center. This lets you see every team member and their current status at once.

## Prompt Examples

**Prompt:** 
```
Who is currently online in my support team?
```

**Response:** 
```
Fetching agent statuses...

| Agent Name | Status | Team |
| :--- | :--- | :--- |
| John Doe | **Online** | Support |
| Sarah Smith | **On Call** | Support |
| Mike Ross | **Offline** | Support |

There are currently 2 agents active in your support team.
```

**Prompt:** 
```
Can you get the recording link for call 12345?
```

**Response:** 
```
I've retrieved the recording for call **12345**. 

You can access the secure audio file here: [Recording Link]

Let me know if you need the metadata for this call as well.
```

**Prompt:** 
```
What are our call metrics for today?
```

**Response:** 
```
Here are your current call center metrics:

* **Total Calls:** 142
* **Avg. Duration:** 4m 12s
* **Service Level:** 94%
* **Missed Calls:** 3

Would you like to see a breakdown of these metrics by team?
```

## Capabilities

### Pull call recordings
Get direct links to audio files for quality assurance.

### Monitor agent status
See who is online or busy at any moment.

### Track telephony metrics
Get a high-level view of call volumes and service levels.

### Search phone numbers
Find new numbers to add to your global inventory.

### Manage data exports
Check the status of your historical data downloads.

### View team metadata
Get details on how your agent groups are structured.

## Use Cases

### Checking agent availability
A support lead asks the agent to see who is free to take a new ticket to balance the workload.

### Quality assurance review
An analyst asks for the recording link for a specific call ID to share with a teammate for training.

### Regional expansion
A manager finds a local number for a new office to expand the company's reach into a new market.

### Performance reporting
An ops person checks the latest call center metrics to see if the team hit their weekly targets.

## Benefits

- Get recording links instantly to skip the manual search in your dashboard.
- Monitor live agent availability so you can see who is online or busy at a glance.
- Track your organization's service levels to spot trends in call volume.
- Find new regional phone numbers to expand your global reach without extra effort.
- Oversee your team structure easily to ensure your routing is optimized.
- Keep your data projects on track by checking export progress.

## How It Works

The bottom line is you get a natural language interface for your entire cloud phone system.

1. Subscribe to this Connector on the Vinkius marketplace.
2. Add your Freshcaller Domain and API Key from your profile settings.
3. Ask your AI client to check call logs or agent status.

## Frequently Asked Questions

**Can I use Freshcaller MCP to place phone calls?**
No, this Connector is for managing your phone system data. It lets you track calls, get recordings, and see agent status, but it doesn't place calls itself.

**How do I get recording links for my team?**
You can ask your agent to find a specific recording by providing the call ID. It will then give you a direct link to the audio file in the chat.

**Can I see my agent teams with Freshcaller?**
Yes, you can ask the agent to list your teams or get specific details about how they are structured to help with routing.

**Does Freshcaller MCP show real-time call volume?**
Yes, you can ask for your account metrics to see your current call volumes and service levels across the organization.

**How do I find new phone numbers?**
You can ask your agent to search for buyable numbers. It will look through available options so you can scale your reach.

**Can I check if my data export is finished?**
Yes, you can ask the agent to check the status of your export jobs to see if your historical data is ready.

**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.