# Freshservice — how to use (mcp.ai)

Connect your Freshservice account and use 12 tools for customer support straight from your AI agent. Connect with your own API key. Freshservice is a cloud-based IT service management (ITSM) solution with incident management, asset management, and IT service automation capabilities.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_freshservice?ms=1787295960000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `freshservice_bulk_update_tickets`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/freshservice`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/freshservice/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/freshservice/bulk/update/tickets` — Tool to bulk update multiple Freshservice tickets by sequential update calls. Use when you need to update fields across many tickets in absence of a native bulk API.
  - body: { ids: integer[], update_fields: object }
- `POST https://api.mcp.ai/api/freshservice/create/service/request` — Create a service request for a catalog item in Freshservice using the v2 API. The catalog item display_id can be found in Admin > Service Catalog by clicking on an item and checking the URL (e.g., /se
  - body: { email?: string, quantity?: integer, custom_fields?: object, item_display_id: integer, parent_ticket_id?: integer }
- `POST https://api.mcp.ai/api/freshservice/create/ticket` — Tool to create a new ticket. Use when you need to log an incident or service request.
  - body: { name?: string, type?: string, email?: string, impact?: string, source?: string, status: string, subject: string, urgency?: string, priority: string, cc_emails?: string[], description: string, requester_id?: integer, email_config_id?: integer }
- `POST https://api.mcp.ai/api/freshservice/delete/release` — Tool to delete a release from Freshservice. Use when you need to permanently remove a release from the system. This action is irreversible — the release cannot be recovered once deleted.
  - body: { release_id: integer }
- `POST https://api.mcp.ai/api/freshservice/delete/solution/article` — Tool to delete a solution article from the knowledge base by its ID. This action is irreversible — the article cannot be recovered once deleted. Use this action when you need to permanently remove a s
  - body: { article_id: integer }
- `POST https://api.mcp.ai/api/freshservice/delete/solution/category` — Tool to delete a solution category in Freshservice. Use this action when you need to remove a solution category that is no longer needed. This action is irreversible — the category cannot be recovered
  - body: { category_id: integer }
- `POST https://api.mcp.ai/api/freshservice/get/problem/form/fields/by/workspace` — Tool to list problem form fields. Use when you need to retrieve the form fields available for problems in a specific workspace.
  - body: { workspace_id?: integer }
- `POST https://api.mcp.ai/api/freshservice/get/release/form/fields` — Tool to list release form fields metadata. Use when you need to fetch release field definitions before building or validating release forms.
  - body: { workspace_id?: integer }
- `POST https://api.mcp.ai/api/freshservice/get/ticket` — Tool to retrieve detailed information about a specific ticket by ID. Use when you need to get full details of a ticket including its status, priority, requester, and other attributes.
  - body: { include?: string, ticket_id: integer }
- `POST https://api.mcp.ai/api/freshservice/list/locations` — Tool to list all locations in Freshservice. Use when you need to retrieve paginated location data.
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/freshservice/list/service/catalog/items` — Tool to list all service catalog items in Freshservice. Use when you need to discover available catalog items and their display_ids before creating service requests.
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/freshservice/list/tickets` — Tool to list all tickets in Freshservice with optional filtering and pagination. Use when you need to retrieve ticket IDs or search for tickets. By default only tickets created within the past 30 days
  - body: { page?: integer, filter?: string, include?: string, order_by?: string, per_page?: integer, order_type?: string, updated_since?: string }

## Example prompts
- "What can I do in Freshservice?"
- "Show me a summary of my Freshservice account"

## More
- Page: https://mcp.ai/freshservice
- Agent spec (llms.txt): https://mcp.ai/freshservice/llms.txt
- Postman collection: https://mcp.ai/freshservice/postman.json