# Freshdesk MCP

> Freshdesk MCP lets your AI agent manage all aspects of customer support directly from natural conversation. Instantly list open tickets, check agent availability, retrieve full contact histories, or create new issues without touching a dashboard. It brings the entire knowledge base—from company details to individual ticket threads—into your chat client.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** ticketing-system, incident-management, customer-relationship-management, support-automation, agent-routing

## Description

This MCP connects your favorite AI client to Freshdesk so you can automate customer service operations and handle helpdesk tasks through natural conversation. Forget logging into the support portal; manage everything right where you're working. You can use your agent to list all support tickets, fetch detailed metadata like priority and status, or open entirely new requests instantly. Need context on a user? Get full contact details or company information in one query. The MCP also gives visibility into your team structure by listing agents and accessing configured group queues. All of this data is available through the Vinkius Marketplace, letting you integrate core support functions directly into your existing AI workflow.

It's designed for anyone who needs to move fast: Tech teams can automate ticket creation; Support Managers can monitor agent workloads across groups; and agents can instantly retrieve full conversation histories or requester profiles while they focus on the fix.

## Tools

### list_helpdesk_agents
List support agents

### create_ticket
Open a new ticket

### check_freshdesk_status
Verify helpdesk status

### get_agent_details
Get agent metadata

### get_company_details
Get company metadata

### get_contact_details
Get customer metadata

### get_ticket_details
Get ticket metadata

### list_helpdesk_companies
List client companies

### list_helpdesk_contacts
List customers

### list_ticket_thread
List ticket interactions

### list_tickets
List support tickets

### update_ticket
Modify ticket properties

## Prompt Examples

**Prompt:** 
```
List all open support tickets in my Freshdesk.
```

**Response:** 
```
Retrieving tickets... I found 5 open requests, including 'Broken Login' (Priority: Urgent) and 'Billing Inquiry'. Would you like the full details for the urgent one?
```

**Prompt:** 
```
Show me the conversation thread for ticket '12345'.
```

**Response:** 
```
Fetching thread... For ticket 12345, I found 3 replies and 1 private note. The last update was from Agent Mike stating 'investigating the server logs'.
```

**Prompt:** 
```
Create a new ticket: 'API Access Problem' from 'user@example.com'.
```

**Response:** 
```
Ticket created! I've successfully opened ticket ID 67890 regarding 'API Access Problem' for user@example.com. It has been assigned to the general support queue.
```

## Capabilities

### Automate Ticket Creation
Your agent opens new support tickets with a simple command, assigning them to the right queue.

### View Support Status
Check the overall health and status of your helpdesk system instantly.

### Gather Customer Context
Retrieve detailed metadata for specific contacts or entire company organizations to understand customer history.

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

## Frequently Asked Questions

**How do I get an API Key for Freshdesk?**
Log in to your Freshdesk instance, click on your profile picture in the top-right, and select 'Profile Settings' to find your API Key.

**What is my 'Domain prefix'?**
Your domain prefix is the first part of your Freshdesk URL (e.g. if your URL is 'acme.freshdesk.com', the prefix is 'acme').

**Can I see private notes on a ticket?**
Yes, the 'list_ticket_thread' tool retrieves all interactions associated with a ticket, including public replies and private notes for full agent context.

**Is it possible to filter tickets by status?**
Yes, the 'list_tickets' tool accepts an optional 'filter' parameter (e.g., 'open', 'pending') to help you focus on specific sets of requests.