# BOSSDesk MCP for AI Agents MCP

> BOSSDesk connects your IT Service Management (ITSM) account directly to your AI agent. It lets you manage everything from tracking service tickets and finding specific assets, to querying user directories—all without opening the BOSSDesk portal.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** itsm, asset-management, incident-reporting, service-desk, it-operations, ticket-tracking

## Description

Need to handle complex IT requests but hate switching between dashboards? This MCP plugs your entire BOSSDesk ITSM environment into your natural conversation flow. Your AI agent handles the heavy lifting: you can ask it to list all open tickets, find out who owns a specific laptop by serial number, or check an employee's profile—and it just does it.

If you’re already using Vinkius for other APIs, adding BOSSDesk keeps your IT operations management in one place. You tell your agent what needs fixing, and it interacts with the system to create new tickets, update notes, or even verify if an asset is still assigned to a user. It turns complex, multi-step service workflows into simple chat commands.

## Tools

### add_ticket_note
Appends a public or private comment directly to an existing support ticket.

### create_ticket
Generates and submits a brand new IT support ticket into the system.

### get_asset
Retrieves detailed specifications for one specific piece of equipment using an ID or serial number.

### get_ticket
Fetches the full history and details for a single, specified support ticket.

### get_user
Pulls specific profile information about an employee from the directory.

### list_assets
Provides a comprehensive list of every hardware and software asset managed by the company.

### list_locations
Lists all physical office or site locations registered in the system.

### list_tickets
Returns a summary list of all open and closed IT support tickets.

### list_users
Generates a directory listing containing basic information for every system user.

### update_ticket
Modifies the status or core details of an already existing ticket.

## Prompt Examples

**Prompt:** 
```
Can you list my open tickets and find details on ticket 102?
```

**Response:** 
```
**Open Tickets Summary**
*   Broken Printer (ID: 102) - Status: Waiting for Parts
*   New Laptop Request (ID: 105) - Status: Pending Approval

**Details for Ticket 102:**
The printer issue is confirmed. The initial report mentioned the network connection failing, but a note added today confirms it's likely due to driver incompatibility. Parts ETA: next Tuesday.
```

**Prompt:** 
```
I need the user profile and all assets assigned to John Doe.
```

**Response:** 
```
**User Profile: John Doe**
*   Department: Marketing
*   Manager: Jane Smith
*   Email: john.doe@company.com

**Assigned Assets:**
*   Laptop (ID 502): Dell XPS 15, Assigned Status: In Use. Warranty ends in 6 months.
*   Monitor (ID 311): Samsung Curve, Assigned Status: In Use. Last serviced: Yesterday.
```

**Prompt:** 
```
Add a note to ticket 102 saying we ordered the replacement hardware.
```

**Response:** 
```
**Success:** Note added to Ticket ID 102.

The new private note reads: 'Hardware ordered, tracking number ABC789. Expected delivery date: Oct 3rd.' The ticket status has been updated to 'Waiting for Parts,' keeping all team members informed.
```

## Capabilities

### Create New Support Tickets
Instantly generate a new support ticket and file it under the correct department.

### Query Asset Details
Look up specific hardware or software assets using serial numbers or asset IDs.

### List All Tickets and History
Fetch a list of all support tickets, including detailed history and who originally filed the request.

### Update Ticket Statuses
Change an existing ticket's details or add public notes directly from your agent conversation.

### Check User Directory Info
Pull specific profile data for any employee, like department or manager name.

### Inventory Physical Locations
Get a list of all registered office sites and their details.

## Use Cases

### A new employee needs a laptop and desk setup
Instead of opening multiple forms, you ask your agent to check asset availability (`list_assets`) and then use `create_ticket` to file the request. The agent handles the entire ticket lifecycle from discovery to submission.

### A user reports a broken monitor at their remote site
You tell your agent the issue, and it uses `get_user` to find out who is assigned that asset, then uses `add_ticket_note` on the existing ticket with next steps.

### IT Manager needs a headcount of all managed sites
You prompt your agent to list all physical office locations (`list_locations`). The tool pulls the data and presents it immediately, saving you from navigating complex geographical reports.

## Benefits

- No more clicking through tabs. You can list all tickets or find specific asset details just by asking your agent a question.
- When you need to update information, using the `update_ticket` tool means changing status or adding notes without logging into a dashboard.
- Quickly get user context. The `get_user` capability lets your agent check an employee's profile instantly when resolving a case.
- `list_assets` gives you an immediate inventory overview, letting you verify if equipment exists and who it belongs to—all in plain text responses.
- Write notes directly into the record using `add_ticket_note`, keeping high team visibility on every case without manual updates.

## How It Works

The bottom line is you never have to open the BOSSDesk web portal again just to get basic IT service information.

1. Subscribe to the BOSSDesk MCP on Vinkius.
2. Enter your required API Token and Subdomain credentials into your AI client settings.
3. Start talking to your agent. You can then ask it to list tickets, check assets, or update user records.

## Frequently Asked Questions

**How does the BOSSDesk MCP help me manage tickets without logging into my portal?**
It lets your agent handle ticket creation, status updates, and notes using natural conversation. You get full workflow control over your service requests directly from your chat window.

**Can I use the BOSSDesk MCP to track physical office locations?**
Yes, you can list all registered sites across the organization. This is useful for knowing where specific assets might be located or planning regional rollouts.

**What if I need details on a user's profile using BOSSDesk MCP?**
You just ask your agent to fetch the user record. It pulls accurate data like department, manager, and contact info right into your conversation thread.

**Is the BOSSDesk MCP only for listing things?**
No, it's much more than that. You can create new tickets, update existing ones, and add notes to maintain a complete record of every interaction.

**Does this MCP handle inventory tracking for hardware assets?**
Absolutely. It lets you list all managed IT assets and pull specific details—like serial numbers or warranty status—for any single item you need to check.