# Vision Helpdesk MCP by usefulapi

> Vision Helpdesk MCP by usefulapi is an MCP server. Triage Vision Helpdesk tickets, read conversations, find clients and manage internal handoffs. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/vision-helpdesk/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/vision-helpdesk
- **MCP Registry name:** io.usefulapi/vision-helpdesk
- **Listing updated:** 2026-11-13

## About

Triage Vision Helpdesk tickets, read conversations, find clients and manage internal handoffs.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http vision-helpdesk https://vision-helpdesk.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://vision-helpdesk.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "vision-helpdesk": {
      "url": "https://vision-helpdesk.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "vision-helpdesk": {
      "type": "http",
      "url": "https://vision-helpdesk.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "vision-helpdesk": {
      "serverUrl": "https://vision-helpdesk.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "vision-helpdesk": {
      "type": "http",
      "url": "https://vision-helpdesk.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `vision_get_dashboard_counts`: The ticket counts of the staff dashboard (quick view): for example new, open, overdue and assigned tickets. ticket / quick_view.
- `vision_list_tickets`: List tickets, with at most ONE filter: a ticket id, a status id, a department id or a folder (inbox, new, overdue, assigned, trash, spam, draft). Without a filter it lists the tickets the API user can see. Status ids come from vision_list_statuses. ticket / get_tickets.
- `vision_search_tickets`: Find tickets by an EXACT ticket reference (the ticket hash such as VHD-218) or an EXACT subject. Give one of them. ticket / get_tickets with a filter on ticket_hash or subject.
- `vision_get_ticket`: One ticket with its fields (status, owner, priority, department...) and its posts (the conversation). ticket / ticket_details.
- `vision_list_tickets_by_tag`: Tickets that carry a tag, by tag id. ticket / tag_search.
- `vision_list_tickets_by_label`: Tickets that carry a label, by label id. ticket / search_label_tickets.
- `vision_list_statuses`: The ticket statuses of a department (ids and names), for filters and status changes. ticket / get_status.
- `vision_list_priorities`: The ticket priorities of a department (ids and names). ticket / get_priority.
- `vision_list_ticket_types`: The ticket types of a department (ids and names). ticket / get_ticket_type.
- `vision_list_clients`: List clients (customers), with at most ONE filter: a client id, a first name (exact), or a parent client id (lists that client's contacts). client / get_clients.
- `vision_search_clients`: Search clients by name or email text. client / list_clients.
- `vision_get_client_summary`: A client's summary: notes and ticket counts. client / get_summary.
- `vision_create_ticket`: WRITE: confirm:true required. open a new ticket for a client, given by client id or email. By default no email and no autoresponder is sent; a normal ticket's first post is created on behalf of the client and shown to the client. Internal tickets are staff-only and cannot have client recipients or email enabled. Look up the department, status, priority and type ids first (vision_list_statuses, vis
- `vision_reply_to_ticket`: WRITE: confirm:true required. add a staff reply to a ticket. Say explicitly whether the client can see it (visible_to_client) and whether it is emailed to the client (send_email, default false). ticket / reply_ticket.
- `vision_add_ticket_note`: WRITE: confirm:true required. add an internal note to a ticket (not shown to the client). ticket / add_note with notetype 0.
- `vision_add_client_note`: WRITE: confirm:true required. add an internal note to a client record. ticket / add_note with notetype 1.
- `vision_update_ticket_property`: WRITE: confirm:true required. change one property of a ticket to another id: status, priority, department or type. Look the ids up first (vision_list_statuses and the like). Changing the department can change which statuses and priorities apply. ticket / update_properties.
- `vision_assign_ticket_staff`: WRITE: confirm:true required. add a staff member as an owner of a ticket, or remove one. ticket / update_properties with action staff.
- `vision_add_ticket_tag`: WRITE: confirm:true required. add a tag (by title) to a ticket. ticket / add_live_tag.

## FAQ

### How do I add Vision Helpdesk MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http vision-helpdesk https://vision-helpdesk.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/vision-helpdesk-mcp-by-usefulapi
