# Helpdesk — how to use (mcp.ai)

Connect your Helpdesk account and use 14 tools for customer support straight from your AI agent. Connect with your own API key. HelpDesk is a ticketing system designed to streamline customer support by organizing and managing inquiries efficiently.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_helpdesk?ms=1787295840000`
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. `helpdesk_list_agents`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/helpdesk`
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/helpdesk/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/helpdesk/list/agents` — Retrieves all support agents (team members) in the HelpDesk account. Use this action to get a complete list of agents with their details including: - Agent profiles (name, email, avatar, job title) - 
- `POST https://api.mcp.ai/api/helpdesk/list/canned/responses` — Tool to list canned responses. Use when you need to retrieve all predefined reply templates for tickets.
- `POST https://api.mcp.ai/api/helpdesk/list/custom/fields` — Tool to list all custom fields defined in the account. Use when you need to view or manage custom fields. Only callable after authentication.
- `POST https://api.mcp.ai/api/helpdesk/list/email/domains` — Lists all email domains configured for the HelpDesk account. Returns a comprehensive list of all email domains set up in the HelpDesk account, including domain names, verification status, DNS records,
- `POST https://api.mcp.ai/api/helpdesk/list/licenses` — Retrieves all licenses (account configurations) for the authenticated HelpDesk account. A license represents a customer account and contains subscription information, global settings, default team/tem
- `POST https://api.mcp.ai/api/helpdesk/list/reply/addresses` — Lists all reply addresses configured in the HelpDesk account. Reply addresses are email addresses used to receive and respond to support tickets. Each reply address must be associated with a verified 
- `POST https://api.mcp.ai/api/helpdesk/list/rules` — Tool to retrieve a list of rules configured in the account. Use after authentication when you need an overview of all automation rules.
- `POST https://api.mcp.ai/api/helpdesk/list/subscriptions` — Lists all billing subscriptions for the HelpDesk account, including active, expired, canceled, and future subscriptions. Subscriptions represent the currently selected plan (team or enterprise) and nu
  - body: { state?: string, plan_codes?: string[] }
- `POST https://api.mcp.ai/api/helpdesk/list/teams` — Lists all teams in the HelpDesk account. Returns a comprehensive list of all teams configured in the HelpDesk account, including team IDs, names, settings, reply addresses, and integration configurati
- `POST https://api.mcp.ai/api/helpdesk/list/tickets` — List all tickets from a specified silo with cursor-based pagination support. This tool retrieves tickets from the helpdesk system with flexible sorting and pagination. Use this when you need to retrie
  - body: { silo?: string, order?: string, sortBy?: string, next.ID?: string, prev.ID?: string, pageSize?: integer, next.value?: string, prev.value?: string }
- `POST https://api.mcp.ai/api/helpdesk/list/trusted/emails` — Tool to retrieve a list of trusted email addresses or domains. Use when managing your spam whitelist after authenticating.
- `POST https://api.mcp.ai/api/helpdesk/list/views` — Tool to list agent views. Use when you need to retrieve saved ticket views after authentication.
- `POST https://api.mcp.ai/api/helpdesk/list/webhooks` — Lists all configured webhooks for the HelpDesk account. Webhooks allow you to receive real-time notifications about ticket events (creation, updates, status changes, assignments, etc.) sent as HTTP PO
- `POST https://api.mcp.ai/api/helpdesk/view/agent` — Retrieves comprehensive details for a specific agent in the HelpDesk system. Returns complete agent information including profile details, role assignments, team memberships, status, settings, and sig
  - body: { agentID: string }

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

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