effytech/freshdesk-mcp

Freshdesk MCP Server

An MCP server implementation that integrates with Freshdesk, enabling AI models to interact with Freshdesk modules and perform various support operations.

Features

• Freshdesk Integration: Seamless interaction with Freshdesk API endpoints
• AI Model Support: Enables AI models to perform support operations through Freshdesk
• Automated Ticket Management: Handle ticket creation, updates, and responses

Components

Tools

The server offers several tools for Freshdesk operations:

• create_ticket: Create new support tickets

  • Inputs:
    • subject (string, required): Ticket subject
    • description (string, required): Ticket description
    • source (number, required): Ticket source code
    • priority (number, required): Ticket priority level
    • status (number, required): Ticket status code
    • email (string, optional): Email of the requester
    • requester_id (number, optional): ID of the requester
    • custom_fields (object, optional): Custom fields to set on the ticket
    • additional_fields (object, optional): Additional top-level fields

• update_ticket: Update existing tickets

  • Inputs:
    • ticket_id (number, required): ID of the ticket to update
    • ticket_fields (object, required): Fields to update

• delete_ticket: Delete a ticket

  • Inputs:
    • ticket_id (number, required): ID of the ticket to delete

• search_tickets: Search for tickets based on criteria

  • Inputs:
    • query (string, required): Search query string

• get_ticket_fields: Get all ticket fields

  • Inputs:
    • None

• get_tickets: Get all tickets

  • Inputs:
    • page (number, optional): Page number to fetch
    • per_page (number, optional): Number of tickets per page

• get_ticket: Get a single ticket

  • Inputs:
    • ticket_id (number, required): ID of the ticket to get

• get_ticket_conversation: Get conversation for a ticket

  • Inputs:
    • ticket_id (number, required): ID of the ticket

• create_ticket_reply: Reply to a ticket

  • Inputs:
    • ticket_id (number, required): ID of the ticket
    • body (string, required): Content of the reply
    • cc_emails (array of strings, optional): Additional email addresses added to the 'cc' field of the outgoing email. These supplement the ticket requester, who always remains the primary recipient
    • bcc_emails (array of strings, optional): Additional email addresses added to the 'bcc' field of the outgoing email. These supplement the ticket requester, who always remains the primary recipient
    • from_email (string, optional): Email address the reply is sent from
    • user_id (number, optional): ID of the agent who is adding the reply

• create_ticket_note: Add a note to a ticket

  • Inputs:
    • ticket_id (number, required): ID of the ticket
    • body (string, required): Content of the note

• update_ticket_conversation: Update a conversation

  • Inputs:
    • conversation_id (number, required): ID of the conversation
    • body (string, required): Updated content

• view_ticket_summary: Get the summary of a ticket

  • Inputs:
    • ticket_id (number, required): ID of the ticket

• update_ticket_summary: Update the summary of a ticket

  • Inputs:
    • ticket_id (number, required): ID of the ticket
    • body (string, required): New summary content

• delete_ticket_summary: Delete the summary of a ticket

  • Inputs:
    • ticket_id (number, required): ID of the ticket

• get_agents: Get all agents

  • Inputs:
    • page (number, optional): Page number
    • per_page (number, optional): Number of agents per page

• view_agent: Get a single agent

  • Inputs:
    • agent_id (number, required): ID of the agent

• create_agent: Create a new agent

  • Inputs:
    • agent_fields (object, required): Agent details

• update_agent: Update an agent

  • Inputs:
    • agent_id (number, required): ID of the agent
    • agent_fields (object, required): Fields to update

• search_agents: Search for agents

  • Inputs:
    • query (string, required): Search query

• list_contacts: Get all contacts

  • Inputs:
    • page (number, optional): Page number
    • per_page (number, optional): Contacts per page

• get_contact: Get a single contact

  • Inputs:
    • contact_id (number, required): ID of the contact

• search_contacts: Search for contacts

  • Inputs:
    • query (string, required): Search query

• update_contact: Update a contact

  • Inputs:
    • contact_id (number, required): ID of the contact
    • contact_fields (object, required): Fields to update

• list_companies: Get all companies

  • Inputs:
    • page (number, optional): Page number
    • per_page (number, optional): Companies per page

• view_company: Get a single company

  • Inputs:
    • company_id (number, required): ID of the company

• search_companies: Search for companies

  • Inputs:
    • query (string, required): Search query

• find_company_by_name: Find a company by name

  • Inputs:
    • name (string, required): Company name

• list_company_fields: Get all company fields

  • Inputs:
    • None