# Deskpro MCP by usefulapi

> Deskpro MCP by usefulapi is an MCP server. Search tickets, people, organizations and KB articles in Deskpro, and create tickets and replies. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Search tickets, people, organizations and KB articles in Deskpro, and create tickets and replies.

## Install

### Claude Code (Terminal)

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

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

```sh
https://deskpro.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "deskpro": {
      "url": "https://deskpro.usefulapi.io/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "deskpro": {
      "serverUrl": "https://deskpro.usefulapi.io/mcp"
    }
  }
}
```

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

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

## Tools

- `deskpro_get_me`: Return who the API key acts as — the auth method, the bound person id and their profile. A cheap way to confirm the helpdesk URL and key are right. Deskpro: GET /api/v2/me.
- `deskpro_list_tickets`: List tickets, filtered by status, assigned agent, requester, organization, department or labels, and sorted. Returns ticket objects (id, ref, subject, ticket_status, agent, person, department, urgency, labels, dates) plus pagination meta. Deskpro: GET /api/v2/tickets.
- `deskpro_get_ticket`: Fetch a single ticket by id, with its subject, status, assignment, requester, labels, custom fields, SLA state and timing. A merged ticket redirects to the ticket it was merged into. Deskpro: GET /api/v2/tickets/{id}.
- `deskpro_list_ticket_messages`: List the conversation on one ticket — every reply and agent note, with its author, date, is_agent_note flag and HTML body. Deskpro: GET /api/v2/tickets/{id}/messages.
- `deskpro_list_people`: List people (end users and agents), searchable by name and filterable by email, organization or agent flag. Deskpro: GET /api/v2/people.
- `deskpro_get_person`: Fetch a single person by id — name, emails, phone numbers, organization, labels, custom fields and ticket count. Deskpro: GET /api/v2/people/{id}.
- `deskpro_list_person_tickets`: List the tickets raised by one person — their support history. Deskpro: GET /api/v2/people/{id}/tickets.
- `deskpro_list_organizations`: List customer organizations, filterable by name or labels. Deskpro: GET /api/v2/organizations.
- `deskpro_get_organization`: Fetch a single organization by id — name, summary, email domains, labels, custom fields and ticket count. Deskpro: GET /api/v2/organizations/{id}.
- `deskpro_list_organization_tickets`: List the tickets belonging to one organization. Deskpro: GET /api/v2/organizations/{id}/tickets.
- `deskpro_list_articles`: List knowledgebase articles, filterable by category, status and author. Deskpro: GET /api/v2/articles.
- `deskpro_get_article`: Fetch a single knowledgebase article by id — title, content, status, categories and labels. Deskpro: GET /api/v2/articles/{id}.
- `deskpro_list_departments`: List the ticket departments (id, title, parent, whether tickets/chat are enabled) — needed to route a new ticket. Deskpro: GET /api/v2/ticket_departments.
- `deskpro_list_agents`: List the helpdesk's agents (id, name, email, online state) — needed to assign a ticket. Deskpro: GET /api/v2/agents.
- `deskpro_list_ticket_statuses`: List the ticket statuses and custom sub-statuses (status_type, status_code, title) configured on the helpdesk. Deskpro: GET /api/v2/ticket_statuses.
- `deskpro_search`: Quick search across tickets, people, organizations, articles, news, downloads, community topics and chats; results are grouped by type. Deskpro: GET /api/v2/search.
- `deskpro_create_ticket`: Open a new ticket for a requester (by person id, or by email — Deskpro creates the person if the email is new) with a first message. Depending on the helpdesk's triggers this may email the requester. Returns the created ticket. Deskpro: POST /api/v2/tickets.
- `deskpro_update_ticket`: Change a ticket's subject, status, assignment, department, organization, urgency, hold state or labels. Only the fields you pass are sent. Reversible by updating again. Cannot set the hidden (deleted/spam) status. Deskpro: PUT /api/v2/tickets/{id}.
- `deskpro_add_ticket_message`: Add a message to a ticket as the key's agent. With is_note=true it is an internal agent note (not shown to the requester); with is_note=false it is a REPLY that the helpdesk emails to the requester — that cannot be unsent. Deskpro: POST /api/v2/tickets/{id}/messages.
- `deskpro_create_organization`: Create a customer organization. Email domains auto-associate people with matching addresses. Deskpro: POST /api/v2/organizations.

## FAQ

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

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

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