# HelpCrunch MCP

> HelpCrunch MCP automates your customer support workflow by connecting directly to your chat and customer records. Your agent can list conversations, update client tags, assign chats to specific team members, and pull full transaction history—all through natural conversation.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** multi-channel-support, customer-communication, chat-automation, helpdesk, customer-profiles, email-automation

## Description

Managing customer communication shouldn't mean jumping between five different dashboard tabs just to get one answer. This MCP lets you take control of your entire support process using only your AI client. You can ask your agent to find every chat associated with a specific customer, pulling up their full profile and interaction history in seconds. Need to hand off a complex ticket? Your agent will check the active conversations, reassign the chat to a different department, and update its status—all without you touching the HelpCrunch dashboard. Because this connection is housed within Vinkius, your AI client can access all of these support tools from one place. It functions as a dedicated Support Lead that manages everything from tagging clients to ensuring the right person gets the query.

## Tools

### add_customer_tag
Applies a specific label or tag directly to any customer's profile.

### send_message
Sends a direct message into an active chat conversation for immediate communication.

### get_chat_details
Retrieves all detailed information about one specific, individual chat thread.

### get_customer_details
Fetches the complete profile and history for a single customer ID.

### list_chats
Lists all active and historical conversations to give you an immediate overview of ongoing support work.

### list_customers
Pulls a comprehensive list of every contact record stored in HelpCrunch.

### list_departments
List all support departments

### list_chat_messages
Useful for understanding context or historical interactions.

List all messages within a specific chat

### search_chats
Pass filter criteria as a JSON string in "filter_json" (e.g., {"status": "open"}).

Search for chats using filters

### update_chat_assignee
Assign a chat to a specific team member

### update_chat_status
Update the status of a chat (e.g., closed, open)

## Prompt Examples

**Prompt:** 
```
List all open chats and show the last message for each.
```

**Response:** 
```
I've retrieved your open chats. You have 3 active conversations: 'Billing query' from Sarah, 'API Issue' from Mark, and 'Feedback' from Elena. Sarah's last message was 'When is my next invoice?'. Would you like to see the full transcript for any of these?
```

**Prompt:** 
```
Search for all chats from the customer with email 'john.doe@example.com'.
```

**Response:** 
```
Searching database... I found 2 historical chats for John Doe. The first was about 'Onboarding' (Closed) and the second is an 'Upgrade Request' (Pending). Should I retrieve the messages for the pending request?
```

**Prompt:** 
```
Tag customer ID 5592 with 'VIP' and 'Priority Support'.
```

**Response:** 
```
Tags added! I've successfully applied the 'VIP' and 'Priority Support' labels to customer 5592. They will now be clearly identified in your dashboard. Should I also check if they have any open chats?
```

## Capabilities

### Review and search conversations
List all chats, or use filters to find specific open or historical discussions.

### Access detailed customer data
Pull comprehensive profiles for any customer, including their full history of interactions.

### Update client records and tags
Apply specific labels or tags to a customer profile after an interaction to aid future sorting.

### Manage team workload and routing
Change who owns a chat, assigning it immediately to the correct team member or department.

### Draft communications within chats
Send messages directly into an existing chat thread as part of your workflow.

## How It Works

The bottom line is that your AI client acts as an operational bridge, letting you run complex support tasks using simple commands instead of clicking through multiple web forms.

1. First, subscribe to the HelpCrunch MCP on Vinkius and enter your required API key.
2. Next, tell your AI client exactly what you need—for example, 'Find all open chats for VIP customers in Billing.'
3. Your agent uses these instructions to query HelpCrunch, retrieves the necessary data (like customer details or chat transcripts), and presents the summary directly back to you.

## Frequently Asked Questions

**How do I find my HelpCrunch API Key?**
Log in to your HelpCrunch dashboard, navigate to **Settings > Developers > Public API**. You will be able to generate and copy your unique Bearer token from there.

**Can I reassign a chat to another team member?**
Yes! Use the `update_chat_assignee` tool. You must provide the `chat_id` and the numeric `assignee_id` of the team member you wish to assign the conversation to.

**How can I filter chats by status?**
Use the `search_chats` tool and provide a JSON filter string. For example, to find open chats, pass `{"status": "open"}` in the `filter_json` parameter.

**Is it possible to tag customers through this integration?**
Yes, you can use the `add_customer_tag` tool. Provide the `customer_id` and the name of the tag you want to add to their profile.