Freshservice

The Freshservice tool provides the ability to manage tickets, submit service requests, access knowledge base articles, and handle approvals.

Connection Setup

Connect Freshservice to Dust with a Freshservice Agent account and OAuth.

Before you start:

In Freshservice

  1. Use a Freshservice account with the Agent role, not Requester.

  2. Check that the assigned role can access Tickets, Service Catalog, Knowledge Base, and Approvals.

  3. Make sure the account is not blocked by security restrictions or repeated failed sign-in attempts.

  4. Review the official documentation: Dust Freshservice guide and Freshservice authentication docs.

In Dust:

  1. go to Spaces -> Tools and select Add Tools.
  2. Select Freshservice from the available MCP servers.
  3. Enter your Freshservice domain URL (for example, yourcompany.freshservice.com).
  4. Enter your Freshservice organization URL (for example, yourcompany.myfreshservice.com).
  5. Click Connect to start the OAuth flow.
  6. Sign in with your Freshservice Agent account.
  7. Accept all requested OAuth scopes and complete the authorization flow.
  8. Assign the tool to the relevant Dust agent so it appears in the agent's available actions.

Available Tools

Freshservice provides the following tools:

Ticket Management

ToolDescription
List TicketsLists tickets with optional filtering and pagination.
Get TicketGets detailed information about a specific ticket.
Create TicketCreates a new ticket in Freshservice.
Update TicketUpdates an existing ticket's properties.
Add Ticket NoteAdds an internal note to a ticket.
Add Ticket ReplyAdds a public reply to a ticket conversation.

Task Management

ToolDescription
List Ticket TasksLists all tasks associated with a ticket.
Create Ticket TaskCreates a new task on a ticket.
Update Ticket TaskUpdates an existing task's properties.
Delete Ticket TaskDeletes a task from a ticket.

Service Catalog

ToolDescription
List Service CategoriesLists all service catalog categories.
List Service ItemsLists service catalog items.
Search Service ItemsSearches for service items by keyword.
Get Service ItemGets detailed information about a specific service item.
Get Service Item FieldsGets the field configuration for a service item.
Request Service ItemSubmits a service request for a catalog item.

Knowledge Base

ToolDescription
List Solution CategoriesLists solution categories used to organize folders and articles.
List Solution FoldersLists solution folders within categories.
List Solution ArticlesLists articles within a specific folder.
Get Solution ArticleGets the full content of a specific solution article.
Create Solution ArticleCreates a new solution article in a specified folder.

Approvals

ToolDescription
List Ticket ApprovalsLists all approvals for a specific ticket.
Get Ticket ApprovalGets details of a specific approval.
Request Service ApprovalRequests approval for a ticket.

Organizational Data

ToolDescription
List DepartmentsLists all departments in Freshservice.
List ProductsLists all products/assets.
List RequestersLists requesters with optional filtering.
Get RequesterGets detailed information about a specific requester.
List On-Call SchedulesLists on-call schedules for support teams.
List SLA PoliciesLists SLA policies configured in your instance.
List Purchase OrdersLists purchase orders.
List Canned ResponsesLists available canned responses.
Get Canned ResponseGets the full content of a specific canned response.

Field Discovery

ToolDescription
Get Ticket Read FieldsLists available ticket field IDs for use in read operations.
Get Ticket Write FieldsLists all available ticket fields for create and update operations.

Limitations & Considerations

  • Standard Freshservice API rate limits apply (typically 1000 requests per hour per API key)