Zendesk API MCP Server

A comprehensive Model Context Protocol (MCP) server for interacting with the Zendesk API. This server provides tools and resources for managing Zendesk Support, Talk, Chat, and Guide products.

## Features

- Complete coverage of Zendesk API functionality
- Tools for managing tickets, users, organizations, and more
- Resources for accessing Zendesk API documentation
- Secure authentication with Zendesk API tokens

## Getting Started

### Prerequisites

- Node.js 14 or higher
- A Zendesk account with API access

### Installation

1. Clone this repository
2. Install dependencies:
   ```
   npm install
   ```
3. Create a `.env` file with your Zendesk credentials:
   ```
   ZENDESK_SUBDOMAIN=your-subdomain
   ZENDESK_EMAIL=your-email@example.com
   ZENDESK_API_TOKEN=your-api-token
   ```

### Running the Server

Start the server:
```
npm start
```

For development with auto-restart:
```
npm run dev
```

### Testing with MCP Inspector

Test the server using the MCP Inspector:
```
npm run inspect
```

## Available Tools

### Tickets
- `list_tickets`: List tickets in Zendesk
- `get_ticket`: Get a specific ticket by ID
- `create_ticket`: Create a new ticket
- `update_ticket`: Update an existing ticket
- `delete_ticket`: Delete a ticket

### Users
- `list_users`: List users in Zendesk
- `get_user`: Get a specific user by ID
- `create_user`: Create a new user
- `update_user`: Update an existing user
- `delete_user`: Delete a user

### Organizations
- `list_organizations`: List organizations in Zendesk
- `get_organization`: Get a specific organization by ID
- `create_organization`: Create a new organization
- `update_organization`: Update an existing organization
- `delete_organization`: Delete an organization

### Groups
- `list_groups`: List agent groups in Zendesk
- `get_group`: Get a specific group by ID
- `create_group`: Create a new agent group
- `update_group`: Update an existing group
- `delete_group`: Delete a group

### Macros
- `list_macros`: List macros in Zendesk
- `get_macro`: Get a specific macro by ID
- `create_macro`: Create a new macro
- `update_macro`: Update an existing macro
- `delete_macro`: Delete a macro

### Views
- `list_views`: List views in Zendesk
- `get_view`: Get a specific view by ID
- `create_view`: Create a new view
- `update_view`: Update an existing view
- `delete_view`: Delete a view

### Triggers
- `list_triggers`: List triggers in Zendesk
- `get_trigger`: Get a specific trigger by ID
- `create_trigger`: Create a new trigger
- `update_trigger`: Update an existing trigger
- `delete_trigger`: Delete a trigger

### Automations
- `list_automations`: List automations in Zendesk
- `get_automation`: Get a specific automation by ID
- `create_automation`: Create a new automation
- `update_automation`: Update an existing automation
- `delete_automation`: Delete an automation

### Search
- `search`: Search across Zendesk data

### Help Center
- `list_articles`: List Help Center articles
- `get_article`: Get a specific Help Center article by ID
- `create_article`: Create a new Help Center article
- `update_article`: Update an existing Help Center article
- `delete_article`: Delete a Help Center article

### Talk
- `get_talk_stats`: Get Zendesk Talk statistics

### Chat
- `list_chats`: List Zendesk Chat conversations

## Available Resources

- `zendesk://docs/{section}`: Access documentation for different sections of the Zendesk API

## License

MIT

A comprehensive Model Context Protocol (MCP) server for interacting with the Zendesk API. This server provides tools and resources for managing Zendesk Support, Talk, Chat, and Guide products. ## Features - Complete coverage of Zendesk API functionality - Tools for managing tickets, users, organizations, and more - Resources for accessing Zendesk API documentation - Secure authentication with Zendesk API tokens ## Getting Started ### Prerequisites - Node.js 14 or higher - A Zendesk account with API access ### Installation 1. Clone this repository 2. Install dependencies: ``` npm install ``` 3. Create a `.env` file with your Zendesk credentials: ``` ZENDESK_SUBDOMAIN=your-subdomain ZENDESK_EMAIL=your-email@example.com ZENDESK_API_TOKEN=your-api-token ``` ### Running the Server Start the server: ``` npm start ``` For development with auto-restart: ``` npm run dev ``` ### Testing with MCP Inspector Test the server using the MCP Inspector: ``` npm run inspect ``` ## Available Tools ### Tickets - `list_tickets`: List tickets in Zendesk - `get_ticket`: Get a specific ticket by ID - `create_ticket`: Create a new ticket - `update_ticket`: Update an existing ticket - `delete_ticket`: Delete a ticket ### Users - `list_users`: List users in Zendesk - `get_user`: Get a specific user by ID - `create_user`: Create a new user - `update_user`: Update an existing user - `delete_user`: Delete a user ### Organizations - `list_organizations`: List organizations in Zendesk - `get_organization`: Get a specific organization by ID - `create_organization`: Create a new organization - `update_organization`: Update an existing organization - `delete_organization`: Delete an organization ### Groups - `list_groups`: List agent groups in Zendesk - `get_group`: Get a specific group by ID - `create_group`: Create a new agent group - `update_group`: Update an existing group - `delete_group`: Delete a group ### Macros - `list_macros`: List macros in Zendesk - `get_macro`: Get a specific macro by ID - `create_macro`: Create a new macro - `update_macro`: Update an existing macro - `delete_macro`: Delete a macro ### Views - `list_views`: List views in Zendesk - `get_view`: Get a specific view by ID - `create_view`: Create a new view - `update_view`: Update an existing view - `delete_view`: Delete a view ### Triggers - `list_triggers`: List triggers in Zendesk - `get_trigger`: Get a specific trigger by ID - `create_trigger`: Create a new trigger - `update_trigger`: Update an existing trigger - `delete_trigger`: Delete a trigger ### Automations - `list_automations`: List automations in Zendesk - `get_automation`: Get a specific automation by ID - `create_automation`: Create a new automation - `update_automation`: Update an existing automation - `delete_automation`: Delete an automation ### Search - `search`: Search across Zendesk data ### Help Center - `list_articles`: List Help Center articles - `get_article`: Get a specific Help Center article by ID - `create_article`: Create a new Help Center article - `update_article`: Update an existing Help Center article - `delete_article`: Delete a Help Center article ### Talk - `get_talk_stats`: Get Zendesk Talk statistics ### Chat - `list_chats`: List Zendesk Chat conversations ## Available Resources - `zendesk://docs/{section}`: Access documentation for different sections of the Zendesk API ## License MIT