# BoldDesk MCP for AI Agents MCP

> BoldDesk connects your entire customer service operation to any AI agent. Manage ticket status, access full contact histories, and update support records using plain conversation. You can create new tickets or add private notes directly from the chat window, eliminating the need to jump between dashboards.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** support-tickets, customer-service, ticketing-automation, helpdesk, customer-communication

## Description

Managing a help desk shouldn't mean jumping between tabs and copying IDs. This MCP lets your AI agent handle complex support workflows through natural conversation. Instead of logging into BoldDesk to list tickets, you simply ask your agent for an overview of active issues or specific customer profiles. The system pulls the necessary data—whether it’s retrieving a contact’s full history or adding a private note to ticket 102—and presents it back immediately. This capability means agents can handle multi-step requests without ever leaving their current workflow tool. Because this MCP lives on Vinkius, you connect once and gain access to BoldDesk's functions alongside thousands of other services from our catalog.

## Tools

### add_ticket_note
Adds a confidential, internal note to an existing support ticket so the team knows about it.

### create_ticket
Opens and submits an entirely new support ticket for a customer or user.

### get_agent
Retrieves the detailed profile information for one specific support agent.

### get_contact
Fetches all known details about a particular customer or contact record.

### get_ticket
Pulls the complete, detailed status and history for one specific ticket ID.

### list_agents
Gets a comprehensive list of all support agents currently set up in BoldDesk.

### list_contacts
Retrieves a directory listing of every customer contact record available.

### list_tickets
Lists the IDs and basic status of all support tickets currently in the system.

### reply_to_ticket
Adds a public reply to a ticket, which the customer will see immediately.

### update_ticket
Makes general changes or modifications to an existing support ticket record.

## Prompt Examples

**Prompt:** 
```
What are all my open tickets and who is assigned to them?
```

**Response:** 
```
**Open Ticket Summary**

*   **Ticket ID: 102** | Subject: Login Issue | Status: Open | Assigned To: Sarah M.
*   **Ticket ID: 105** | Subject: Billing Inquiry | Status: Needs Review | Assigned To: John D.
*   **Ticket ID: 119** | Subject: API Timeout | Status: New | Assigned To: Unassigned

Please follow up with Sarah on the login issue.
```

**Prompt:** 
```
I need to create a new ticket for user chris@example.com regarding payment failure.
```

**Response:** 
```
**Success!** A new support ticket has been created.

*   **Ticket ID:** 120
*   **Subject:** Payment Failure - Urgent
*   **Status:** New
*   **Assigned To:** Unassigned

Chris will receive a confirmation email shortly. Let me know if you need to add any initial internal notes.
```

**Prompt:** 
```
Get the contact details for user 503 and tell me their last ticket status.
```

**Response:** 
```
**Contact Details: John Smith**
*   **Email:** john@corp.com
*   **Phone:** (555) 123-4567
*   **Account Status:** Active

His most recent ticket, ID 105, is currently in **Needs Review** status and was last updated 4 hours ago.
```

## Capabilities

### Get full ticket history
Retrieve all details for a specific support ticket, including public replies and internal private notes.

### Create new tickets quickly
Open an entirely new support ticket in BoldDesk using only the conversation prompt.

### Respond to customers or staff
Add public replies visible to the customer, or add private internal notes for team visibility.

### Manage contact data
Access and retrieve details about any individual user or customer in your directory.

### Monitor support staff activity
List all active agents and get specific profiles to track who is assigned to which tasks.

## Use Cases

### A customer reports a service outage, but you need to check the account first.
You ask your agent: 'What is the history for user Jane Doe?' The agent uses `get_contact` and then drafts a reply based on that data. You don't have to switch apps; the whole process happens in conversation.

### A team member needs to update a ticket but doesn't know the ID.
The colleague asks: 'Can you find all billing inquiries and mark them as resolved?' The agent runs `list_tickets`, identifies the relevant IDs, and then uses `update_ticket` on your behalf.

### A developer needs to automate bug reporting.
The dev prompts: 'Create a new ticket for API timeout affecting user XYZ.' The agent calls `create_ticket`, logging the issue immediately without needing credentials or manual form filling.

## Benefits

- Stop clicking through dashboards. You can list all open support tickets using the `list_tickets` tool, getting an immediate overview without navigating to a specific dashboard view.
- Speed up issue tracking by creating new issues instantly. Need to file something? Use `create_ticket` and get it submitted with a single prompt.
- Improve team visibility. Instead of asking a colleague for status updates, use the AI agent to pull full details on any ticket using `get_ticket`, knowing exactly where the issue stands.
- Keep sensitive info internal. You can add private notes directly to a ticket using `add_ticket_note` so only your internal team sees it.
- Centralize people data. Easily look up customer records with `get_contact` or get details on specific staff members by calling `get_agent`.

## How It Works

The bottom line is that after connecting it, your agent treats BoldDesk like a native function, allowing you to perform complex actions without any manual setup or coding.

1. Subscribe to the BoldDesk MCP on Vinkius.
2. Enter your unique BoldDesk API Key and Domain into the connection settings.
3. Your AI client immediately gains access, letting you manage all support tasks via chat.

## Frequently Asked Questions

**Can the BoldDesk MCP help me keep track of all my active support tickets?**
Yes. You can ask your agent to list all open tickets and get immediate details, including who they are assigned to and what their current status is.

**How do I use the BoldDesk MCP for AI Agents if a customer asks me something complex?**
You can have your agent pull the necessary contact history or ticket details first. This gives you all the context you need to draft an accurate, informed reply without switching applications.

**Does this MCP let me update tickets from outside of BoldDesk?**
Absolutely. You can use your agent to modify existing records, like marking a ticket as resolved or adding internal notes for the team that will take over next.

**What if I need to create a new issue but don't have an ID?**
You just tell the agent who needs help and what the problem is. The MCP handles creating the ticket, assigning it, and submitting all the necessary information for you.

**Can I see a list of my team members or support agents using BoldDesk?**
Yes, the agent can pull a comprehensive list of your support staff and even grab individual profiles to help you monitor team activity assignments.