# Deskpro MCP for AI Agents MCP

> Deskpro helps you run a full helpdesk operation through natural conversation. Use this MCP to manage tickets, access user profiles, and pull knowledge base articles—all without opening the Deskpro dashboard. Your AI client acts as your centralized operations coordinator for customer support.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** omnichannel-support, self-service-portal, sla-tracking, ticket-automation, help-center, customer-service

## Description

You can take control of complex customer support workflows by connecting your helpdesk directly to an AI agent. Instead of manually navigating multiple screens to find information or update records, you simply talk to your agent. It handles the heavy lifting: pulling user history from profiles, retrieving relevant articles from the knowledge base, and even opening new tickets when necessary.

This MCP makes your AI client function as a dedicated operations team member. You can ask it to summarize ticket histories across departments or check if an account has hit a specific service level agreement deadline. Because this connection is managed through Vinkius, you connect once from any compatible tool and instantly gain full visibility into every aspect of your customer relationship management (CRM) system.

## Tools

### check_api_health
Verifies if your connection to Deskpro is currently working.

### create_new_helpdesk_ticket
Opens a new support ticket, requiring you to provide a subject, the person's email, and an initial message.

### get_article_content
Retrieves the full content and details for a specific knowledge base article.

### get_ticket_details
Fetches all information about one specific support ticket, including its status and history.

### get_user_profile
Pulls a complete record of an individual end-user account.

### list_helpdesk_agents
Lists all internal support staff (agents) who work with the helpdesk.

### list_kb_articles
Retrieves a list of available articles in your knowledge base so you know what topics are covered.

### list_user_organizations
Lists all organizational memberships associated with an end-user account.

### list_helpdesk_tickets
Provides a list of helpdesk tickets, allowing you to filter by status or department.

### list_helpdesk_users
Retrieves a comprehensive list of all end-users in your system.

### list_configured_webhooks
Lists the active webhooks set up for automated service operations.

### update_ticket_properties
Modifies specific details or properties of an existing support ticket, like changing its priority.

## Prompt Examples

**Prompt:** 
```
I need to see all open tickets for our enterprise clients that are stuck with no response.
```

**Response:** 
```
**Ticket Summary: High-Risk Items**

*   **ID 452:** Billing Inquiry (Priority: Medium). Last Update: 3 days ago. Status: Awaiting Internal Review.
*   **ID 789:** Login Failure (Priority: High). Last Update: Today, 1 hour ago. Status: Awaiting User Response.

I recommend following up on ID 452; the last update was quite a while ago.
```

**Prompt:** 
```
What's wrong with user 'john.doe@company.com'? Need to know his account status.
```

**Response:** 
```
**User Profile: John Doe**

*   **Status:** Active/Premium Tier (since 2021).
*   **Organization:** TechCorp Inc.
*   **Memberships:** [Admin], [Billing Contact].
*   **Last Activity:** Viewing the 'API Setup' guide (Knowledge Base ID: 987).
```

**Prompt:** 
```
List all support agents who handle payments or billing issues.
```

**Response:** 
```
**Available Billing Specialists**

We found these team members listed as experts in financial services:
*   Sarah K. (ID: 301) - Primary contact for invoices.
*   Marcus D. (ID: 412) - Handles annual billing cycles.
*   Emily R. (ID: 550) - Specialist in subscription plans.
```

## Capabilities

### Manage the entire ticket lifecycle
List all active and closed tickets, check their details, update properties, or even create a brand new support case.

### Access customer identity records
Pull full profiles for any end-user, view organizational memberships, or list the different groups an organization belongs to.

### Retrieve knowledge articles instantly
Search and retrieve specific content from your help center's article library, providing instant answers for self-service support.

### Coordinate internal teams
Get a list of available support agents or administrators to figure out who handles which type of issue.

### Monitor system health and configuration
Check the API connection status, view existing webhooks, or examine account metadata for reliable operations.

## Use Cases

### A customer reports an outage, but the account status is unknown.
The agent uses get_user_profile to confirm who reported the issue and list_user_organizations to understand their company structure. They can then use list_helpdesk_tickets to find related tickets, giving the user a comprehensive answer in seconds.

### A team needs to know which agents are available for a specialized service.
Instead of calling internal directories, the agent runs list_helpdesk_agents. It instantly shows who specializes in billing or server issues, allowing the support lead to route the ticket correctly.

### A new issue pops up and needs documentation immediately.
The agent uses list_kb_articles to search the help center by keyword. It then retrieves specific content using get_article_content, providing a drafted response based on official documentation.

### A ticket requires an immediate change in priority and ownership.
The support manager uses list_helpdesk_tickets to locate the case. They then use update_ticket_properties to raise the severity level, ensuring it gets addressed immediately by the correct department.

## Benefits

- Summarize ticket histories instantly. Instead of manually reviewing long threads, the agent reads through the full message transcript to give you a concise summary.
- Maintain clear customer relationship records by pulling full profiles using get_user_profile, giving context on account status without leaving your chat window.
- Reduce time spent finding information. Use list_kb_articles and get_article_content to surface relevant self-service guides immediately for agents.
- Improve service reliability by checking system metadata. The check_api_health tool verifies API connectivity instantly, letting you know if the issue is internal or external.
- Automate ticket workflow. You can create a new support case using create_new_helpdesk_ticket and immediately update its priority using update_ticket_properties.

## How It Works

The bottom line is that you never have to leave your chat interface. Your AI handles the complex API calls and hands you clean, actionable data.

1. Subscribe to this MCP on Vinkius.
2. Get your unique API Key and Instance URL from your Deskpro Admin Portal under Apps & Integrations.
3. Start asking your AI client questions like, 'List all high-priority tickets for the billing department,' or 'Find articles about password resets.' The agent uses those credentials to pull real-time data.

## Frequently Asked Questions

**How does the Deskpro MCP help me track my customer support tickets?**
It lets you list and get details for all your tickets, allowing you to filter by status or department. You can also update properties like priority directly through conversation.

**Can I find out if a user is associated with multiple companies using the Deskpro MCP?**
Yes. You can list all organizations linked to a user account, giving you full context on their business relationships and status across different entities.

**Does the Deskpro MCP let me access help center documentation easily?**
Absolutely. It lets you list available articles and retrieve the full content of any knowledge base article instantly, making it easy to draft accurate responses for customers.

**How do I know if my support system is working correctly when using Deskpro MCP?**
The MCP includes a tool to check the API health status and list configured webhooks. This helps you confirm that all your connections are operational before starting complex tasks.

**Does this MCP help me manage my team's support assignments?**
You can retrieve directories of all available support agents and administrators. This is useful for coordinating complex issue routing or checking who has the right permissions.