# AskHandle MCP for AI Agents AI Agent Connect > AskHandle MCP. Connects your AI agent to your AskHandle account to manage chats, capture leads, and handle webhooks. It lets your agent act as a customer support rep or a lead gen bot by interacting with your existing chat infrastructure to keep your data organized. ## Overview - **Category:** customer-support - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_yOLWSe32aY0D9KU6jiNeNnA6BDMbkRqxqYikYkrS/ai-agent-connect - **Tags:** conversational-ai, lead-capture, customer-engagement, helpdesk, chat-automation, webhook ## Description AskHandle MCP lets you hook up your AI agent to the AskHandle platform so it can actually do the heavy lifting of customer engagement. Instead of you having to jump between tabs to check on chat rooms or manually log new leads, your agent can handle it all from one place. You can have your agent fetch a list of current rooms to see what's happening, grab specific details on a lead that just came in, or fire off a message to a customer who's waiting for a response. It also handles the plumbing, like setting up new webhooks to trigger actions in other apps or deleting old ones when they're no longer needed. If you're using Vinkius to manage your Connector stack, this is the piece that turns a static chat tool into a dynamic, automated support system. Your agent can see the big picture of your leads and messages, making it much easier to keep customers happy without constant manual intervention. You can use it to quickly verify your account status or pull specific conversation details to give your agent the context it needs to provide better answers. It's built for people who want to move away from manual data entry and toward a system where the AI actually interacts with the customer data. By giving your agent the ability to read and write to your chat history, you can create a loop where the AI learns from previous interactions to provide more accurate support. This means fewer repeated questions for your customers and a more consistent experience for everyone involved. ## Tools ### create_lead Create a new lead record in your AskHandle account. This helps you keep track of every person who interacts with your site. ### create_room Generate a new chat room for a specific customer interaction. Use this to start fresh conversations with new visitors. ### create_webhook Set up a new webhook subscription to trigger actions in other apps. This connects your chat data to your wider tech stack. ### delete_webhook Remove an old or unused webhook subscription. Keep your integrations clean by deleting what you don't need. ### list_leads See a full list of all the leads you've captured so far. This is the quickest way to see who's interested in your product. ### list_messages Pull a list of messages from your chat rooms. You can filter these to focus on specific conversations. ### list_rooms View all the active and past chat rooms in your account. This gives your agent a bird's-eye view of current activity. ### list_webhooks See a list of all the webhooks you currently have active. Use this to audit your outgoing integrations. ### retrieve_lead Get the full details of a specific lead. This helps your agent understand a customer's history before replying. ### retrieve_room Pull the specific details for a single chat room. Use this to focus the conversation on one specific interaction. ### send_message Send a message to a specific chat room. This is how your agent actually talks to your customers. ### get_me Check your API connection and get account context. Use this to make sure everything is working before you start. ## Prompt Examples **Prompt:** ``` Are there any new leads from today? ``` **Response:** ``` I've checked your leads. You have 3 new entries from today, including 'John Doe' and 'Sarah Smith' from the 'Inquiry' chat. ``` **Prompt:** ``` Show me what's happening in the chat rooms right now. ``` **Response:** ``` You have 4 active chat rooms. Here is the status: - Room 1: 'Pricing Question' (Active) - Room 2: 'Technical Issue' (Pending) - Room 3: 'General Inquiry' (Active) - Room 4: 'Billing' (Closed) ``` **Prompt:** ``` Send a 'Thanks for reaching out' message to the last room. ``` **Response:** ``` I've sent that message to the most recent chat room. The customer should see it in their window now. ``` ## Capabilities ### Automate lead capture Automatically save visitor information into your lead database as soon as they provide it in chat. ### Manage chat rooms View, retrieve, and create specific chat sessions to keep track of all customer interactions. ### Send messages Have your agent reply to customers in real-time to provide immediate support. ### Handle webhooks Set up and manage automated triggers to connect your chat data to your other software tools. ### Fetch lead data Get all the details on a specific person who reached out to help your agent understand their history. ## Use Cases ### Automatic Lead Logging A sales rep is busy on a call and asks the agent to 'log the lead from the last chat.' The agent uses `create_lead` to pull the visitor's name and email from the conversation and save it to your database instantly, so nothing gets missed. ### Support Overflow A support manager gets a spike in tickets and tells the agent to 'check all active rooms.' The agent uses `list_rooms` to scan every active chat, identifies the ones with the longest wait times, and alerts the manager to where help is needed most. ### Instant Greetings A new visitor joins a chat and waits for a response. The agent uses `send_message` to provide an immediate greeting and ask how it can help, ensuring the customer feels attended to the second they land on your site. ### Webhook Auditing An operations person is troubleshooting a broken automation and asks the agent to 'show me all active webhooks.' The agent uses `list_webhooks` to provide a full inventory of active triggers, helping the user identify which one is misconfigured. ### Lead Deep Dive A customer service rep wants to know more about a specific inquiry before calling the client. They ask the agent to 'get details on lead 123,' and the agent uses `retrieve_lead` to pull the full history and notes for that specific person. ## Benefits - Automate lead capture: Use `create_lead` to save visitor info instantly without manual data entry. This means your sales team won't have to copy and paste details from a chat window into your database, which cuts down on human error and keeps your CRM clean. - Real-time chat management: Your agent can use `list_rooms` and `retrieve_room` to stay on top of active conversations. It allows the AI to see which customers are currently waiting for help and what they've already said so it can provide relevant answers. - Automated responses: Use `send_message` to have your agent reply to customers immediately. This significantly improves your average response time, ensuring that no customer is left hanging while your team is busy with other tasks. - Clean webhook management: Use `create_webhook` and `delete_webhook` to keep your automation triggers organized. You can set up specific actions for new signups or alerts and then prune the old ones to keep your integrations running smoothly. - Centralized lead tracking: Use `list_leads` to see every potential customer in one place for easier follow-ups. Instead of searching through different chat logs, your agent can pull a complete list of everyone who's expressed interest in your product. - Verified connections: Use `get_me` to ensure your agent always has the right context and a working connection. This prevents the agent from trying to perform actions when the API is down and helps it understand your account details for better accuracy. ## How It Works The bottom line is your AI agent gets direct control over your AskHandle customer interactions and lead data. 1. Connect your AskHandle API keys to the Connector. 2. Grant your agent permission to access your chat rooms and lead records. 3. Ask your agent to perform tasks like 'Send a greeting to the latest room' or 'List all new leads'. ## Frequently Asked Questions **Can AskHandle MCP help me capture leads automatically?** Yes, it lets your AI agent create new lead records as soon as a visitor provides their information during a chat. This removes the need for manual data entry and keeps your CRM updated in real-time. **How does AskHandle MCP manage my chat rooms?** Your agent can list all active rooms and pull specific details for any single room to understand the conversation history. This helps your agent provide better context when responding to customers. **Can I use AskHandle MCP to send automated messages?** Definitely. Your agent can use the `send_message` tool to reply to customers in real-time. This allows you to provide immediate support and improve your response times significantly. **Does AskHandle MCP support webhooks?** Yes, it allows your agent to create, list, and delete webhook subscriptions. This connects your chat data to other software tools to trigger automated actions across your tech stack. **Can AskHandle MCP check my account connection?** You can have your agent use `get_me` to verify that the API connection is active and healthy at any time. This ensures your agent always has the correct account context for its tasks. **How do I see all the leads my agent has captured?** Just ask your agent to list your leads, and it will pull a full list of everyone who's interacted with your chat. It's a quick way to see who's interested in your product without leaving your chat interface. **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.