# AskHandle MCP > AskHandle provides full control over your conversational AI infrastructure. Use this MCP to manage chat rooms, automate messaging workflows, and capture detailed lead information directly from your agent client. It connects your entire customer support and sales funnel into a single API layer. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** conversational-ai, chat-automation, lead-capture, customer-engagement, messaging-workflows, ai-chat ## Description It's all about controlling the conversation data. This connector lets you treat your entire conversational AI setup—the chat rooms, the incoming messages, and the resulting leads—as structured data points accessible via natural language commands. You can run through specific conversations, check who submitted a lead, or even set up triggers that notify other systems when something changes. It removes the friction of managing chat interfaces in isolation; instead, you're working directly with the core data streams. We know managing multiple messaging platforms is a headache, which is why Vinkius hosts this MCP to let your agent client talk directly to AskHandle’s backend. This means no more context switching—you manage everything from one place. ## Tools ### create_lead Manually generates a new lead record in the system. ### create_message Sends a message to a room and gets an AI-generated reply back. ### create_room Establishes a brand new chat room for a specific conversation session. ### create_webhook Sets up a real-time subscription to be notified when an event happens. ### delete_lead Removes a specific lead record from the system entirely. ### delete_room Deletes an entire chat room session when it's no longer needed. ### delete_webhook Removes a previously set up webhook subscription. ### get_lead Retrieves all the specific details for one particular lead record. ### get_message Fetches the content and metadata of a single message exchange. ### get_room Retrieves all details about a specific chat room, including its history. ### get_webhook Gets the configuration and status of a single webhook subscription. ### list_leads Lists all existing lead records in the system for review. ### list_messages Retrieves a list of recent messages across various rooms. ### list_rooms Shows a complete rundown of all currently active chat rooms. ### list_webhooks Lists every webhook subscription that is currently running and active. ### update_lead Changes the information on an existing lead record, like adding notes or changing status. ### update_room Modifies settings for a specific chat room without deleting it. ### update_webhook Changes the target URL or parameters of an existing webhook subscription. ## Prompt Examples **Prompt:** ``` List all my active chat rooms. ``` **Response:** ``` I've retrieved your rooms. You have 3 active sessions: 'Support-User-A' (UUID: 8821), 'Sales-Inquiry' (UUID: 9932), and 'General-Help' (UUID: 1102). Which one would you like to inspect? ``` **Prompt:** ``` Send a message 'How can I help you today?' to room uuid '8821'. ``` **Response:** ``` Message sent to room 8821. The AI response was: 'Hello! I am looking for information about your pricing plans.' ``` **Prompt:** ``` Show me all leads captured since 2024-01-01. ``` **Response:** ``` I found 12 leads captured since January 1st. The most recent ones are 'John Doe' (john@example.com) and 'Jane Smith' (jane@example.com). Would you like the full details for any of them? ``` ## Capabilities ### Manage Chat Sessions Create, read, update, and delete specific chat rooms or view a list of all active sessions. ### Control Messaging Flows Send messages to any designated room and receive the AI-generated response in return. ### Manage Lead Records Create, retrieve, update, or delete specific lead entries captured through your chat interfaces. ### Automate System Triggers Set up and manage webhook subscriptions to react in real time when new messages or leads are created. ### Inspect Conversation Data Fetch deep metadata for rooms, messages, or leads to analyze user behavior and performance. ## Use Cases ### Following up on a high-value lead. A sales rep reviews the chat history for a prospect. They use `get_room` to see all messages, then use `list_leads` to confirm the contact info, and finally use `update_lead` to add internal notes about the next follow-up call. ### Setting up automated alerts for support tickets. The dev team needs to know immediately if a chat room hits zero activity. They set up a webhook using `create_webhook` that triggers an alert in their ticketing system the second a room becomes inactive. ### Cleaning up old data. At month-end, the marketing team needs to archive leads from last quarter. They use `list_leads` to find records older than 90 days and then use `delete_lead` to clean out the stale entries. ### Testing AI response failure points. A developer wants to test how their system handles an invalid message. They use `create_message` with bad parameters, immediately checking the result using `get_message` to confirm the error handling was correct. ## Benefits - You can instantly capture new leads using the `create_lead` tool, ensuring no valuable conversation data is lost because of manual process delays. - Need to analyze a specific user journey? Use `get_room` or `list_messages` to pull all history for a chat session and understand exactly what was said. - When an important event occurs—like a new message arriving—you can use `create_webhook` to trigger external notifications, letting other systems react automatically. - The ability to perform bulk actions like listing all leads (`list_leads`) or updating room details with `update_room` saves time by eliminating repetitive dashboard clicks. - If you're testing messaging logic, the combination of `create_message` and then using `get_message` lets you verify both your outgoing message and the AI’s exact reply. ## How It Works The bottom line is, it gives your AI client direct, programmatic access to every piece of conversation data you generate or store. 1. First, subscribe to this MCP on Vinkius and input your unique AskHandle API key. 2. Next, tell your AI client which resource you need. For example, asking to 'list all chat rooms' or 'get lead details by ID'. 3. The tool executes the command against the AskHandle system, returning structured data that your agent can read and act upon. ## Frequently Asked Questions **How do I list all my active chats using AskHandle? Use list_rooms.** You call `list_rooms` to get a comprehensive rundown of every chat room currently running. The tool returns details for each session, so you know exactly what's active. **What is the best way to capture new leads with AskHandle? Use create_lead.** You use `create_lead` when a conversation generates a qualified lead. This tool allows you to manually structure and save that contact information, making it immediately usable for marketing follow-ups. **Can I automatically notify another system about new chat messages? Use create_webhook.** Yes, setting up a webhook using `create_webhook` allows you to subscribe to real-time events. When a message arrives in any room, your external system gets an instant notification. **How do I view the history of a specific user conversation? Use get_room.** You call `get_room` and provide the unique ID. This tool pulls all metadata and message content, giving you the full chat transcript for review. **How do I review all message exchanges or audit a conversation using list_messages?** You use list_messages to retrieve a full log of messages. This is useful for auditing an entire chat history, not just one room. It provides a comprehensive view of the dialogue flow across multiple sessions. **If a specific chat session is finished and I need to remove it, how do I use delete_room?** To clean up unused data, call delete_room with the room's unique ID. This immediately removes the record from your active list, freeing up resources without affecting other conversations. **I retrieved a lead using get_lead; how do I correct or add details like job title using update_lead?** You use update_lead to modify existing records. Simply pass the lead's ID and the new data fields you want to change. This is perfect for updating captured information after initial qualification. **How do I test a follow-up conversation or simulate user input using create_message?** To initiate a dialogue, call create_message and provide the room ID along with your prompt. The MCP handles sending the message and returns the AI's generated response for immediate testing. **Can I send a message to a specific room and get an AI response?** Yes! Use the `create_message` tool. You can provide the message body and the `room_uuid` to interact with a specific conversation session. **How do I filter leads by date?** You can use the `list_leads` tool with the optional `start_date` and `end_date` parameters (formatted as YYYY-MM-DD) to retrieve leads from a specific period. **Is it possible to automate notifications for new leads?** Absolutely. Use the `create_webhook` tool to subscribe to the `lead.added` event and point it to your target URL for real-time notifications.