# AskHandle MCP > AskHandle gives your AI agent control over customer support operations. It connects directly to chat rooms, allowing you to capture visitor data and manage message threads without manual copy-pasting. Use it to create new leads, track conversations, send follow-up messages, and set up webhooks for automated actions. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** conversational-ai, lead-capture, customer-engagement, helpdesk, chat-automation, webhook ## Description This MCP lets your agent handle the messy parts of customer interaction. Instead of having to manually check multiple dashboards or switch between messaging platforms just to grab a lead's name, you can let your AI client do it all in one go. It manages the lifecycle: from capturing initial visitor details to organizing chat rooms and sending follow-up messages. The agent uses this connection to read conversation history, list existing leads, and even set up webhooks so that when a specific event happens—like a room being closed or a lead reaching certain criteria—a webhook fires off the data automatically. You'll find all these tools centralized on Vinkius, letting your agent interact with chat rooms and message queues directly. It’s basically giving your AI client hands in the field: they can now create new records for sales follow-up, retrieve detailed account context for troubleshooting, or simply list every active room to give you an overview of where things stand. ## Tools ### create_lead Creates a new contact record from conversation data. ### create_room Sets up an entirely new chat room session. ### create_webhook Registers a new external endpoint that gets notified of system events. ### delete_webhook Removes an existing webhook subscription after it's no longer needed. ### get_me Verifies the connection status and retrieves account-level information. ### list_leads Fetches a list of all leads captured in the system. ### list_messages Retrieves messages, with an option to filter results by a specific room ID. ### list_rooms Lists all current chat rooms in the system. ### list_webhooks Provides a list of all configured webhook subscriptions. ### retrieve_lead Gets detailed information for one specific lead using its ID. ### retrieve_room Retrieves the full details of a single chat room. ### send_message Sends outbound text to an active chat room. ## Prompt Examples **Prompt:** ``` List all active chat rooms in AskHandle. ``` **Response:** ``` Fetching active rooms... You currently have 5 active sessions. The latest is 'Support Query - Ticket #402'. ``` **Prompt:** ``` Send a message 'Hello' to room 'ROOM_ID'. ``` **Response:** ``` Message 'Hello' successfully sent to room 'ROOM_ID'. ``` **Prompt:** ``` List all captured leads. ``` **Response:** ``` I've retrieved your leads. You have 24 new leads from this week, including 'Acme Corp' and 'TechLogix'. ``` ## Capabilities ### Capture New Leads The agent creates a structured record for a potential customer based on the conversation data. ### Manage Chat Sessions You can create, list, and get detailed information about active chat rooms. ### Send Messages The agent sends a message directly into an existing chat room for follow-up or clarification. ### Audit Conversation History It pulls the full thread of messages, optionally filtering by a specific chat room ID. ### Automate Data Flow You can create and delete webhook subscriptions to trigger external actions when key events occur in the support system. ## Use Cases ### Following up on a chat session A sales rep needs to follow up with 'Acme Corp' after they left the support chat. Instead of asking an employee to manually look through logs, the agent calls `list_rooms` to find the ID and then uses `send_message` to send a targeted follow-up message. ### Weekly lead cleanup The marketing ops team needs to validate all leads captured last week. The agent runs `list_leads`, finds records that are missing key data, and then uses `retrieve_lead` on those specific IDs for manual review. ### Implementing a notification system The engineering team needs to know when a support room is closed. They use `create_webhook`, pointing it to an internal alert service, so the webhook triggers exactly when the event happens. ### Onboarding new agents A new agent needs to see all active projects. The agent runs `list_rooms` and can also use `retrieve_room` to get deep context on any single, complex session for training purposes. ## Benefits - Stop losing track of leads. By using `list_leads` or `retrieve_lead`, your agent instantly gives you a clear inventory of every potential client captured, so nothing slips through the cracks. - Never manually update CRM records again. Calling `create_lead` ensures that conversation data is immediately transformed into actionable sales records, keeping your pipeline current. - Maintain context across threads. If you need to know what was said three days ago, running `list_messages` and filtering by room ID pulls the full history without guesswork. - Automate follow-up actions. You can set up a webhook using `create_webhook`. For example, when a chat room status changes, an external system gets notified instantly. - Know your scope immediately. The agent's ability to execute `get_me` confirms connectivity and gives you the necessary account context before any major operation runs. ## How It Works The bottom line is: your AI client reads the necessary API endpoints to execute actions or retrieve context based on your natural language prompt. 1. The agent first checks its connectivity using `get_me` to confirm it has access to your account context. 2. Next, you instruct the agent to retrieve data, perhaps calling `list_rooms` to see what sessions are active, or running `list_leads` for a summary of captured contacts. 3. Finally, if the goal is action, the agent might call `send_message` with specific content and a target room ID. ## Frequently Asked Questions **How do I list all active chat rooms with AskHandle MCP?** You call `list_rooms`. This tool returns a list of every room currently managed by your account, giving you an instant overview of ongoing support sessions. **Can I send messages using the create_room or send_message tools?** The agent uses `send_message` to post text into a room. You need to know the specific room ID first, which you can get by calling `list_rooms`. **What is the difference between list_leads and retrieve_lead?** `list_leads` gives you an array of all lead records. Use `retrieve_lead` when you already have a specific lead ID and need its full, detailed record. **How do I set up webhooks with AskHandle MCP?** You use the `create_webhook` tool, providing the target URL and defining the event trigger. Remember to run `list_webhooks` later if you need to manage or delete them. **What does `get_me` do to check my API connection before running other commands?** It confirms your API access status and returns core account context. Running this first verifies connectivity, making sure all subsequent tools like `create_lead` or `list_rooms` will work without hitting an authentication error. **How do I use `delete_webhook` to clean up old subscriptions?** You provide the unique ID of the webhook you want gone. This process removes the subscription entirely, preventing your AI client from sending messages or data updates to an outdated endpoint. **If I use `list_messages`, can I filter results by a specific chat room?** Yes, you specify the room ID in the parameters. This lets you narrow down conversation history and pull messages only from one session, which is way better than getting a massive dump of unrelated data. **What kind of details can I get using `retrieve_room`?** This tool pulls deep metadata for a single chat room. You'll get information like its exact creation date, last active user, and unique identifiers—all the context you need to verify a session. **What are 'Rooms' in AskHandle?** Rooms represent chat sessions or conversation contexts between a user and an AI agent. **How are leads captured?** Leads can be captured automatically by your AI agent during a conversation or created programmatically via the API. **Is it possible to manage webhooks directly from the chat?** Yes, you can register new webhooks to receive real-time notifications about events in AskHandle directly using the AI.