# HelpCrunch MCP for AI Agents AI Agent Connect > HelpCrunch MCP. Manage customer support chats, customer profiles, and team assignments directly from your AI agent. Stop switching tabs and start handling tickets, tagging users, and reassigning chats using natural language. ## Overview - **Category:** customer-support - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_FKAcqTB0MhgvZASJLtE78SNfirz4Cw82va7NNfvY/ai-agent-connect - **Tags:** helpdesk, email-marketing, customer-engagement, crm, conversational-support, knowledge-base ## Description This Connector lets you run your helpdesk from a chat window. Instead of digging through a dashboard to find a customer's history or manually moving tickets between departments, you just tell your agent what to do. You can pull up full transcripts, check customer tags, and update statuses without ever leaving your workspace. It turns your AI into a dedicated support lead that knows your customers inside out. You can find specific issues using filters, reassign chats to the right people, and keep your team organized in real time. When you host this via the Vinkius catalog, it connects your entire support stack to any AI client you already use. It takes the friction out of customer success by putting the data where you actually work. ## Tools ### create_customer Requires email and name. Create a new customer profile ### get_conversation_details Get details for a specific chat ### get_customer_details Retrieve full profile information for a single customer. This shows you their history and current status. ### list_team_agents List all agents/team members ### list_conversations List all customer chats ### list_customers View a list of all contacts stored in your HelpCrunch account. Use this to see your total customer base. ### list_departments See all the different support departments you have set up. This helps you understand your team structure. ### list_messages_in_chat List messages from a specific chat ### list_active_webhooks List configured webhooks ### search_customers Search for customers using filters ### send_chat_message Can be sent as an agent. Post a message to a chat ### update_conversation_status g., open, pending, closed). Change chat status ## Prompt Examples **Prompt:** ``` Find the last three messages from the customer with email john@example.com. ``` **Response:** ``` I've found the recent history for John Doe. Here are the last 3 messages: * **User:** "I'm having trouble with the API keys." * **Agent:** "I can help with that. Could you provide the error code?" * **User:** "It's showing a 403 Forbidden error." Would you like me to pull the full transcript for this conversation? ``` **Prompt:** ``` Move all open chats from the billing department to the technical support team. ``` **Response:** ``` I'm reassigning those tickets now. I've identified 4 open chats in the Billing department and moved them to the Technical Support team. **Summary of actions:** - Chat #123: Moved to Tech Support - Chat #125: Moved to Tech Support - Chat #129: Moved to Tech Support - Chat #130: Moved to Tech Support ``` **Prompt:** ``` Add a 'VIP' tag to the customer who just messaged about their API keys. ``` **Response:** ``` Done! I've added the **VIP** tag to the customer profile associated with that chat. They will now be highlighted in your dashboard. ``` ## Capabilities ### Pull conversation transcripts Get full chat histories to understand customer context. ### Apply custom labels Add tags to customer profiles to identify VIPs or specific needs. ### Route chats to teams Reassign tickets to different team members or departments instantly. ### Update ticket statuses Change chat states like snoozed, open, or closed from your agent. ### Filter customer issues Search for specific chats using status or other criteria. ## Use Cases ### Handling a VIP escalation A manager asks the agent to find a customer by email, check their history with get_customer_details, and then use add_customer_tag to mark them as high priority. ### Daily queue management A support lead asks the agent to list_chats filtered by open status and then uses update_chat_assignee to distribute them to the team. ### Onboarding follow-up A success rep uses list_chat_messages to read a past onboarding conversation and then uses send_message to ask the customer a follow-up question. ### Audit and reporting A manager asks the agent to list_departments and search_chats to find all closed tickets from the last week to check for response times. ## Benefits - Quickly find customer history with get_customer_details so you don't have to hunt through old emails. - Keep your queue organized by using update_chat_status to snooze or close tickets from your chat window. - Improve team coordination by using update_chat_assignee to route complex issues to the right department instantly. - Identify high-value leads by using add_customer_tag to mark VIPs or priority accounts on the fly. - Get a birds-eye view of your support volume by using list_chats and search_chats to monitor active issues. ## How It Works The bottom line is you get a hands-on way to manage support tickets using only natural language. 1. Subscribe to the HelpCrunch MCP on Vinkius. 2. Enter your HelpCrunch API Key from the Settings menu. 3. Ask your agent to list chats or find customer details. ## Frequently Asked Questions **Can I use HelpCrunch MCP to see my full chat history?** Yes, you can ask your agent to pull up any conversation history. It will retrieve the full transcript so you can see exactly what was discussed in the past. **How does HelpCrunch MCP help my support team manage tickets?** It lets your team handle ticket statuses, reassignments, and customer lookups using natural language. This means less time clicking and more time solving problems. **Can HelpCrunch MCP update my customer tags automatically?** You can ask your agent to apply specific tags to customer profiles on the fly. This is great for marking VIPs or flagging specific issues as they happen. **Does HelpCrunch MCP work with Claude and Cursor?** Yes, it works with any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code. **Can I use HelpCrunch MCP to reassign chats to different people?** Absolutely. You can tell your agent to move a chat to a specific team member or a different department instantly. **How do I connect HelpCrunch MCP to my AI agent?** Just subscribe to the Connector on Vinkius and provide your HelpCrunch API Key from your developer settings. From there, your agent can access your support data. **Can HelpCrunch MCP help me filter for specific customer issues?** Yes, you can ask your agent to search for chats using specific filters like status or other criteria to find exactly what you need quickly. **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. **How do I generate an API Key in HelpCrunch?** Log in to your HelpCrunch account, navigate to **Settings** > **Developers** > **Public API**, and click **Generate New API Key** to obtain your token. **Can the agent respond to customers directly?** Yes! Use the `send_chat_message` tool to post replies into any active chat thread. The message will appear as coming from your agent account. **How do I search for a customer by email?** The `search_customers` tool allows you to perform lookups using filters like email, name, or external ID to retrieve specific user profiles.