# HelpCrunch MCP > HelpCrunch MCP connects your agent directly to multi-channel customer support workflows. It lets you list all active chats, retrieve deep customer history, update profiles instantly, and send replies—all from one place without leaving your main application. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** helpdesk, email-marketing, customer-engagement, crm, conversational-support, knowledge-base ## Description This connector turns your AI client into a dedicated support coordinator for your entire customer communication stack. You can manage every aspect of the user lifecycle using natural conversation. Need to know what happened in a chat last week? Your agent retrieves all that metadata and history instantly. Want to update a customer's VIP status or add their company size? It writes that data back to the system, keeping your records accurate. If you’re looking for powerful connectors like this, Vinkius is where you find them. You stop manually switching between chat windows, searching through emails, and updating separate CRMs. Your agent handles the heavy lifting: it can triage open chats, pull team agent directories to check capacity, or send a quick message right into an ongoing conversation—all without you ever touching a dashboard button. ## Tools ### create_customer Builds a brand new customer profile using an email address and name. ### get_conversation_details Pulls all the information for one specific chat conversation ID. ### get_customer_details Retrieves a customer's full profile and recorded details. ### list_team_agents Gets a directory of all team members and their current agent status. ### list_conversations Generates a full list of every customer chat conversation ID. ### list_customers Provides an exhaustive listing of all customers in the system. ### list_departments Shows a list of department names configured for support routing. ### list_messages_in_chat Retrieves every message that was sent in a specific chat conversation. ### list_active_webhooks Displays the list of webhooks that are currently set up in your account. ### search_customers Filters the customer database to find specific users based on provided criteria. ### send_chat_message Posts a message into an existing chat thread from the agent's perspective. ### update_conversation_status Changes the status of a conversation, marking it as open, pending, or closed. ## Prompt Examples **Prompt:** ``` List all active customer chats in HelpCrunch. ``` **Response:** ``` I've found 5 active conversations. Notable chats include an inquiry from 'John' (ID: c_101) about pricing and a support request from 'Sarah' (ID: c_102). Which one should I open for you? ``` **Prompt:** ``` Search for customer with email 'jane.doe@example.com'. ``` **Response:** ``` I've located Jane Doe's profile (ID: 789). She is a 'VIP' customer based in London and has 3 previous interactions with our support team. Would you like to see her full activity history? ``` **Prompt:** ``` Send a message to chat ID 'c_101' saying 'I'm checking that for you right now'. ``` **Response:** ``` Done! Message delivered to chat c_101. The customer will see your reply in the chat window immediately. I'll let you know if they respond. ``` ## Capabilities ### View all customer conversations Lists every active and past chat interaction for immediate review. ### Search for specific users Finds customers quickly using filters like email or name instead of scrolling through a list. ### Manage customer records Creates new user profiles and updates existing details to maintain an accurate database. ### Send messages in active chats Posts replies directly into a chat thread as if you were typing it manually. ### Change support ticket status Marks conversations as open, pending, or closed to keep team workflows moving efficiently. ## Use Cases ### Onboarding a new high-value lead A sales rep gets a chat from a prospect. Instead of taking notes in an external sheet, they ask their agent to first `search_customers` by the provided email to see if the user exists. If not, they run `create_customer`, capture all the profile data, and then use that record ID to send a personalized greeting via `send_chat_message`. ### Closing out an inquiry A support agent resolves a complex billing issue. They ask their agent to first pull the full details using `get_conversation_details`. Once resolved, they tell the MCP to run `update_conversation_status` and mark it as 'closed', ensuring the ticket leaves the active queue. ### Investigating a missing record A CSM needs data on a customer who claims their account was never created. They ask the agent to run `list_customers` and filter by partial name, or they can use `get_customer_details` if they have an ID, confirming the user's full activity history. ### Coordinating a team handoff A chat becomes complex. The agent needs to transfer ownership. They first run `list_team_agents` to see who is available and then use that information when they ask the MCP to update the status, signaling it's ready for the next specialized department. ## Benefits - Update user data without context switching. Instead of jumping between your CRM and chat system to change a VIP status, you simply ask the agent to run `update_customer` with the new attributes. - Maintain visibility across departments. You can check team capacity by running `list_team_agents`, so you know if you should route that high-priority query immediately or wait until another agent is free. - Get a full conversation history instantly. Need to reference what was said three days ago? Running `list_messages_in_chat` pulls the entire thread, giving your agent everything it needs for context. - Keep chats organized and flowing. After responding, instead of manually clicking buttons, you tell the MCP to run `update_conversation_status`, marking the ticket as 'pending' or 'closed'. - Efficiently find leads. You don't have to scroll through thousands of records; running `search_customers` filters down to exactly who you need, whether by email or name. - Communicate directly in the flow. Instead of logging into a separate chat client just to send an update, using `send_chat_message` delivers your reply instantly within the conversation. ## How It Works The bottom line is you tell your agent what to do with natural language, and it handles the API calls and data retrieval automatically. 1. Subscribe to this MCP on Vinkius and grab your API key from your HelpCrunch account settings. 2. Connect your AI client (like Cursor or Claude) using the provided credentials. 3. Ask your agent what you need—for example, 'Find all open chats for customers in California.' The tool executes the query and returns structured data. ## Frequently Asked Questions **How do I use `list_conversations` with HelpCrunch MCP?** You simply ask the agent to list conversations. It retrieves a full manifest of all chats, letting you see which ones are active or require attention. **Can I update user details using `update_customer`?** Yes, you can programmatically change customer records. Just provide the target customer's identifier along with the attributes you want to modify. **What is the best way to get chat history? Using `list_messages_in_chat`?** That’s right. Running `list_messages_in_chat` pulls every single message sent in a specific conversation, giving you a complete historical record for context. **Does HelpCrunch MCP allow me to search customers by name? Use `search_customers`.** Yes. The `search_customers` tool lets you filter the database using various criteria like email or specific names, making it much faster than browsing. **I need to manage my integrations, so how can I list all configured webhooks using `list_active_webhooks`?** This tool displays every webhook currently set up in your HelpCrunch account. You check this list when you need to audit which external systems are connected or if a hook needs updating. **How do I efficiently manage chat queues and team workload using `update_conversation_status`?** You change the status of any chat—open, pending, or closed—with this tool. This is critical for ensuring that chats are routed to the right agent and that your department's overall capacity stays organized. **If I need to know who is available on my support team, how do I use `list_team_agents`?** This function pulls a directory of all agents in your team. It gives you visibility into everyone's current status and helps you plan which team member can take on the next high-priority query. **When I need historical data or reporting, how do I use `list_customers` to get a full roster of accounts?** This tool retrieves a complete list of every customer record in your system. Use it when you need bulk data for reporting purposes or want to confirm the existence of an account before running specific actions. **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.