Skip to main content

Freshdesk MCP Server

Create a powerful Model Context Protocol (MCP) server for Freshdesk in minutes with our AI Gateway. This guide walks you through setting up seamless customer support integration with comprehensive ticketing and instant API authentication.

About Freshdesk API​

Freshdesk is a cloud-based customer support software that enables businesses to streamline customer conversations across multiple channels. The API provides comprehensive access to tickets, contacts, agents, automation, and analytics capabilities.

Key Capabilities​

  • Ticket Management: Create, update, and track support tickets
  • Contact Management: Customer and company profiles
  • Agent Productivity: Assignment, collision detection, canned responses
  • Automation: Ticket routing, SLA management, triggers
  • Multi-channel Support: Email, phone, chat, social media
  • Knowledge Base: Solution articles and FAQs
  • Reporting: Analytics and performance metrics
  • Time Tracking: Agent productivity and billing

API Features​

  • RESTful API: JSON over HTTPS
  • API Key Authentication: Simple and secure
  • Rate Limiting: 1000 requests per hour
  • Pagination: Handle large datasets
  • Webhooks: Real-time notifications
  • Custom Fields: Extensible data model
  • Bulk Operations: Mass updates
  • Attachments: File handling support

What You Can Do with Freshdesk MCP Server​

The MCP server transforms Freshdesk API into a natural language interface, enabling AI agents to:

Ticket Management​

  • Ticket Operations

    • "Create urgent ticket for customer complaint"
    • "Update ticket status to resolved"
    • "Assign ticket to senior agent"
    • "Merge duplicate tickets"

  • Ticket Search

    • "Find all open tickets from VIP customers"
    • "Show overdue tickets"
    • "List tickets awaiting customer response"
    • "Search tickets about billing issues"

  • Bulk Actions

    • "Close all spam tickets"
    • "Reassign tickets from John to Sarah"
    • "Update priority for product bug tickets"
    • "Add tag to all feature requests"

Contact & Company Management​

  • Contact Operations

    • "Create new customer contact"
    • "Update customer email address"
    • "Mark contact as VIP"
    • "View customer ticket history"

  • Company Management

    • "Add new enterprise customer"
    • "Link contacts to company"
    • "Update company renewal date"
    • "Set custom SLA for company"

  • Contact Search

    • "Find contacts without recent activity"
    • "List VIP customers"
    • "Show contacts with multiple tickets"
    • "Search by custom fields"

Agent Management​

  • Agent Operations

    • "Check agent availability"
    • "Update agent skills"
    • "Set out of office"
    • "View agent workload"

  • Groups & Roles

    • "Create support group"
    • "Assign agents to groups"
    • "Set group escalation rules"
    • "Configure role permissions"

  • Performance Tracking

    • "Show agent response times"
    • "Calculate resolution rates"
    • "Track customer satisfaction"
    • "Monitor SLA compliance"

Automation & Workflows​

  • Automation Rules

    • "Create ticket routing rule"
    • "Set up auto-response"
    • "Configure SLA policies"
    • "Build escalation workflow"

  • Triggers & Observers

    • "Trigger on high priority tickets"
    • "Notify manager on escalation"
    • "Auto-assign based on skills"
    • "Update fields on status change"

  • Macros & Canned Responses

    • "Create response template"
    • "Build resolution macro"
    • "Share macro with team"
    • "Track macro usage"

Knowledge Base​

  • Article Management

    • "Create solution article"
    • "Update FAQ section"
    • "Publish troubleshooting guide"
    • "Archive outdated content"

  • Categories & Folders

    • "Organize by product"
    • "Create category structure"
    • "Set access permissions"
    • "Manage article visibility"

  • Search & Suggestions

    • "Find relevant articles"
    • "Suggest solutions for ticket"
    • "Track article effectiveness"
    • "Identify content gaps"

Analytics & Reporting​

  • Performance Metrics

    • "Generate SLA report"
    • "Show ticket volume trends"
    • "Calculate average response time"
    • "Track customer satisfaction"

  • Custom Reports

    • "Build agent productivity report"
    • "Analyze ticket categories"
    • "Export data for analysis"
    • "Schedule report delivery"

  • Dashboards

    • "Create team dashboard"
    • "Monitor real-time metrics"
    • "Set up alerts"
    • "Track KPIs"

Settings & Configuration​

  • Business Hours

    • "Set support hours"
    • "Configure holidays"
    • "Define SLA timings"
    • "Manage time zones"

  • Email Configuration

    • "Set up support mailbox"
    • "Configure email templates"
    • "Manage signatures"
    • "Set reply settings"

  • Custom Fields

    • "Add ticket fields"
    • "Create contact properties"
    • "Set field dependencies"
    • "Configure validations"

Prerequisites​

  • Access to Cequence AI Gateway
  • Freshdesk account (Trial or paid plan)
  • API key from Freshdesk admin
  • Your Freshdesk subdomain

Step 1: Configure Freshdesk API Access​

1.1 Get Your API Key​

  1. Log in to your Freshdesk account
  2. Click on your profile picture Profile Settings
  3. In the right panel, you'll find your API key
  4. Copy the API key (keep it secure!)

1.2 Note Your Domain​

Your Freshdesk domain is: https://yourcompany.freshdesk.com

1.3 Verify API Access​

Test your API key:

curl -u YOUR_API_KEY:X https://yourcompany.freshdesk.com/api/v2/tickets

1.4 Check Rate Limits​

  • Default: 1000 requests per hour
  • Enterprise: Higher limits available
  • Monitor X-RateLimit headers

Step 2-4: Standard Setup​

Follow standard steps to access AI Gateway, find Freshdesk API, and create MCP server.

Step 5: Configure API Endpoints​

  1. Base URL: https://yourcompany.freshdesk.com/api/v2
  2. API Version: v2 (recommended)
  3. Endpoints: Select required modules
  4. Click Next

Step 6: MCP Server Configuration​

  1. Name: "Freshdesk Support"
  2. Description: "Customer support ticketing"
  3. Request Timeout: 30 seconds
  4. Click Next

Step 7: Configure Authentication​

  1. Authentication Type: Basic Auth
  2. Username: Your API key
  3. Password: X (literal character X)
  4. Test connection

Available Freshdesk API Operations​

Ticket APIs​

  • Ticket Operations

    • Create ticket
    • View ticket
    • Update ticket
    • Delete ticket
    • List all tickets
    • Filter tickets
    • Search tickets

  • Ticket Fields

    • List ticket fields
    • Create custom field
    • Update field

  • Conversations

    • Add note
    • Add reply
    • Update conversation
    • List conversations

Contact APIs​

  • Contact Management

    • Create contact
    • View contact
    • Update contact
    • Delete contact
    • List contacts
    • Search contacts

  • Company Management

    • Create company
    • View company
    • Update company
    • List companies

Agent APIs​

  • Agent Management

    • List agents
    • View agent
    • Update agent
    • Check availability

  • Groups

    • List groups
    • Create group
    • Update group
    • Assign agents

  • Roles

    • List roles
    • View permissions

Automation APIs​

  • Automation Rules

    • List rules
    • Create rule
    • Update rule
    • Enable/disable

  • SLA Policies

    • List SLAs
    • Create SLA
    • Update targets

Solution APIs​

  • Articles

    • Create article
    • Update article
    • List articles
    • Search articles

  • Categories

    • Create category
    • List categories
    • Update category

Step 8-10: Complete Setup​

Configure security settings, choose deployment options, and deploy your server.

Using Your Freshdesk MCP Server​

Setup Instructions:

Natural Language Commands​

  • "Create a high priority ticket about server outage"
  • "Show me all tickets from john@example.com"
  • "Update ticket #1234 status to pending"
  • "Find solution articles about password reset"
  • "Assign all new tickets to available agents"

Common Use Cases​

Customer Support Operations​

  • Ticket triage and routing
  • SLA management
  • Customer communication
  • Escalation handling

Knowledge Management​

  • Solution articles
  • FAQ maintenance
  • Self-service portal
  • Content effectiveness

Team Management​

  • Workload distribution
  • Performance tracking
  • Skill-based routing
  • Training needs

Process Automation​

  • Auto-responses
  • Ticket categorization
  • Workflow automation
  • Integration triggers

Best Practices​

  1. Ticket Management:

    • Use consistent tagging
    • Set clear priorities
    • Maintain ticket hygiene
    • Regular status updates

  2. Automation:

    • Start simple, iterate
    • Test rules thoroughly
    • Monitor rule impacts
    • Document automation logic

  3. Performance:

    • Use pagination for large datasets
    • Cache frequently used data
    • Batch operations when possible
    • Monitor API usage

Troubleshooting​

Common Issues​

  1. Authentication Errors

    • Verify API key format
    • Check domain spelling
    • Ensure account is active
    • Validate permissions

  2. Rate Limiting

    • Monitor X-RateLimit headers
    • Implement backoff strategy
    • Use bulk operations
    • Cache responses

  3. Data Issues

    • Validate required fields
    • Check field types
    • Handle custom fields
    • Verify ID references

Getting Help​