# Five9 MCP

> Five9 MCP connects your AI client directly to your contact center operations. You can manage agent status, check real-time performance metrics, and handle active calls through natural conversation, instead of clicking dashboards. This lets supervisors quickly assess floor coverage, track campaign health, and even terminate stuck interactions without leaving their chat window.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** contact-center, call-routing, agent-monitoring, real-time-analytics, voice-automation, interaction-management

## Description

This MCP connects any AI client to your Five9 contact center system. It puts the power of supervision right into your chat interface. Instead of logging into separate portals or clicking through complex dashboards just to get a status update, you talk to your agent and it pulls all the operational data. You can check which agents are logged in, see how many calls are waiting in the queue, or find out if a specific campaign is understaffed. The Vinkius Marketplace makes this connection simple: connect once from Claude, Cursor, or any compatible client, and you get full control over your center’s operations through natural language commands. You can even force an agent to log off remotely if they've stepped away from their station.

## Tools

### get_agent_state
Fetches the specific operational status for a single designated agent.

### get_statistics
Retrieves key metrics like Average Handle Time and Service Level across the whole contact center.

### list_active_interactions
Lists all calls or digital interactions that are currently in progress.

### list_agent_groups
Displays a list of all predefined agent groups within the system.

### list_agent_states
Returns a comprehensive inventory of every agent and their current operational status.

### list_campaigns
Shows all the configured marketing or service campaigns running through Five9.

### list_skills
Lists every skill set defined in your contact center routing system.

### list_users
Provides a directory listing of all users configured for the account.

### logout_session
Ends and logs out the supervisor's current session with Five9.

### terminate_interaction
Forces an immediate termination of a specific active call or interaction.

### update_agent_state
Changes the state of an agent to READY, NOT_READY, or LOGOUT remotely.

## Prompt Examples

**Prompt:** 
```
Show me the current state of all agents.
```

**Response:** 
```
Fetching agent states... Currently, 12 agents are 'READY', 5 are 'NOT_READY', and 3 are on 'BREAK'. Would you like the specific details for any individual agent?
```

**Prompt:** 
```
Get real-time contact center statistics.
```

**Response:** 
```
Retrieving statistics... Your organization has an Average Handle Time (AHT) of 4:30, Service Level is at 85%, and there are currently 15 calls waiting in the queue.
```

**Prompt:** 
```
Force agent 'agent_123' to 'LOGOUT' state.
```

**Response:** 
```
Action successful! Agent 'agent_123' has been remotely transitioned to the 'LOGOUT' state. Their supervisor session has been updated.
```

## Capabilities

### Check Agent Status
Instantly list all agents and retrieve detailed status reports for specific team members.

### View Performance Metrics
Pull high-level statistics on your contact center, including Average Handle Time or current Service Levels.

### Manage Calls and Interactions
List all currently active calls or digital interactions and force them to end when necessary.

### Update Agent Presence
Remotely change an agent’s state, forcing them to READY, NOT_READY, or LOGOUT.

### Analyze Center Structure
See all configured campaigns, skills, and user groups used across your organization.

## Use Cases

### Handling sudden staffing gaps
A supervisor notices a major campaign is failing. They ask their agent, 'What are the campaigns and skills that need immediate attention?' The AI responds by running `list_campaigns` and `list_skills`, allowing them to see the coverage gap immediately and decide where to pull staff from.

### Managing an off-site team
An Ops Manager needs to check if three agents are available for a special event. They simply prompt, 'Give me the state of agent A, B, and C.' The MCP calls `get_agent_state` three times, confirming they are all READY before starting the shift.

### Troubleshooting stuck calls
A customer reports a call dropped mid-conversation. Instead of waiting for tech support, the agent runs `list_active_interactions`, identifies the problematic call ID, and uses `terminate_interaction` to clean up the session immediately.

### End of shift cleanup
A supervisor needs to clear out all agents' sessions at closing time. They prompt, 'Log everyone off.' The MCP executes a mass update using `update_agent_state`, changing every agent to LOGOUT and securing the system.

## Benefits

- Stop clicking through dashboards to check agent availability. Use `list_agent_states` to pull a full roster of every agent's status instantly, giving you immediate visibility across the floor.
- Track performance without leaving your workflow. Ask for statistics using `get_statistics` and get key metrics like AHT or Service Level right in your chat response.
- Handle emergencies faster than ever. If a call needs to end immediately, use `terminate_interaction` instead of manually logging into the console to force disconnection.
- Maintain floor coverage effortlessly. You can remotely update an agent's status using `update_agent_state`, ensuring they are flagged as READY or LOGOUT without needing physical access.
- Understand your structure at a glance. Quickly review all available resources by running `list_campaigns` and `list_skills` to understand the full scope of your center's capabilities.

## How It Works

The bottom line is you get real-time operational visibility for your entire contact center through simple text prompts.

1. Subscribe to this MCP through the Vinkius Marketplace.
2. Input your Five9 Virtual Contact Center (VCC) Username and Password into the connection settings.
3. Start managing your contact center operations by asking your AI agent a question in Claude, Cursor, or any compatible client.

## Frequently Asked Questions

**How do I check agent status using Five9 MCP?**
To see the current state of everyone on the floor, ask your agent to run `list_agent_states`. This gives you a comprehensive overview of every user's operational status in real time.

**Can I use Five9 MCP to check campaign details?**
Yes. You can prompt the agent to list all available campaigns using `list_campaigns`, which shows you exactly what services are currently running through your center.

**How do I force an agent offline with Five9 MCP?**
You use the `update_agent_state` tool. Simply tell the agent to change a specific user's status to LOGOUT, and it handles the transition remotely.

**Does Five9 MCP only work for live calls?**
No. In addition to managing active interactions, you can use `list_active_interactions` to see every call that is currently in progress or waiting in the queue.

**What if I need to know how many users exist? Can Five9 MCP help?**
You can get a list of all defined personnel using `list_users`. This provides a directory overview, separate from the real-time operational status.