# FreeScout MCP for AI Agents AI Agent Connect > FreeScout MCP lets you manage your helpdesk directly through your AI client. You can list mailboxes, handle conversations, send replies to customers, and manage your team members or customer profiles using natural language. It turns your helpdesk into an interactive workspace where your agent can actually do the work for you. You can stay on top of tickets and organize your team without leaving your primary workspace. ## Overview - **Category:** communication-messaging - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_D88aFfI6jlE4kcEJ7jjiSRihpCAxHTBrbohb3vcA/ai-agent-connect - **Tags:** shared-inbox, customer-service, open-source, email-management, ticketing-system ## Description The FreeScout MCP lets you manage your helpdesk directly through your AI client. Managing a helpdesk usually means jumping between tabs, copying customer names, and hunting for the right conversation thread. This connector changes that by letting your AI agent do the heavy lifting for you. Instead of clicking through a dashboard, you can just tell your agent to find a specific ticket, summarize the history, or draft a response based on your previous interactions. It handles the busy work of listing mailboxes, creating customers, and updating conversation statuses so you can focus on actually solving problems. Since Vinkius makes it easy to connect these types of tools, you get a setup that feels like a natural extension of your existing workflow. You can keep your team organized by listing users or adding internal notes to threads, all without ever leaving your primary workspace. It's about making the helpdesk work for you, rather than you working for the helpdesk. You won't have to worry about missing a message because your agent can pull up the full thread history for you. You can quickly see which agents are on which tasks and move conversations around whenever you need to. This tool turns your helpdesk into a conversational interface where the goal is to get things done as fast as possible. You can manage your entire customer support operation without the friction of a traditional UI. Whether you are handling a surge of tickets or just trying to keep your internal notes organized, this connection gives you a direct line to your data. ## Tools ### delete_conversation Remove a specific conversation from your records. This helps clean up your active ticket list. ### get_conversation Pull up the full details of a specific conversation. Use this to see the latest updates on a ticket. ### get_customer Fetch all information for a specific customer. This gives your agent the context it needs to help a user. ### get_mailbox Get the details for one of your specific mailboxes. This helps your agent understand how your inbox is structured. ### get_user Look up the details of a specific team member or agent. This is useful for checking internal permissions. ### list_mailboxes See a list of all mailboxes in your FreeScout instance. Use this to find the right inbox for a specific request. ### list_threads View every message thread within a specific conversation. This lets your agent see the full history of a ticket. ### update_conversation Change the status, assignee, or other details of a conversation. This helps you move tickets through your workflow. ### update_customer Edit the information for an existing customer profile. This keeps your records accurate as customer details change. ### create_customer Create a new customer profile in your helpdesk. This helps you keep your customer database organized and up to date. ### list_users See a full list of all users and agents in your system. Use this to manage your team members easily. ### add_note Put an internal note on a conversation for your team. This keeps private information out of the customer's view. ### add_reply Send a direct response back to a customer. This lets your agent communicate with users in real time. ### list_conversations See all conversations currently in a specific mailbox. This helps you scan for new tickets that need attention. ### create_conversation Start a new conversation thread in your helpdesk. Use this to open a new ticket for an incoming request. ### list_customers View a list of all customers in your system. This gives you a high level view of your entire customer base. ## Prompt Examples **Prompt:** ``` What's the latest in my Support mailbox? ``` **Response:** ``` I've checked the **Support** mailbox for you. Here are the most recent conversations: | Conversation ID | Subject | Status | | :--- | :--- | :--- | | #502 | Login Issue | Open | | #505 | API Access | Pending | | #509 | Billing Query | Closed | Would you like me to pull up the thread history for any of these? ``` **Prompt:** ``` Add a note to conversation 502 saying we need to check the logs. ``` **Response:** ``` Done. I've added that internal note to conversation **#502**. Your team will be able to see it in the FreeScout dashboard now. ``` **Prompt:** ``` Summarize the last 3 messages in the 'Billing' thread. ``` **Response:** ``` Here is a summary of the recent messages in the **Billing** thread: * **Customer:** Reported a double charge on their last invoice. * **Agent:** Requested a screenshot of the transaction. * **Customer:** Provided the screenshot and asked for a refund. **Next Step:** You need to verify the transaction in the payment gateway and issue the refund. ``` ## Capabilities ### Send customer replies Have your agent send messages directly to users in your helpdesk. ### List all mailboxes See every inbox in your installation instantly. ### Add internal notes Leave private comments for your team on any conversation. ### Update ticket status Change conversation statuses or assignees with one command. ### Manage customer profiles Create and update customer details through your AI client. ### View thread history Get the full context of a conversation without scrolling. ## Use Cases ### Summarizing long threads An agent asks to view the history of a conversation to understand a complex bug. The agent uses `list_threads` to pull the context and summarize it for the user. ### Batch updating status A manager asks to change the status of all conversations in the billing mailbox. The agent uses `update_conversation` to handle the bulk updates in seconds. ### Drafting replies A support person asks the agent to draft a reply based on a specific customer's history. The agent uses `get_customer` to find the data and `add_reply` to send it. ### Onboarding new customers A team member asks to create a new customer profile and a conversation in one go. The agent uses `create_customer` followed by `create_conversation` to set everything up. ## Benefits - You can resolve tickets faster by using `add_reply` to send customer responses instantly without manual typing. - You can keep your team in the loop by using `add_note` to leave internal feedback on any ticket. - You can see your full inbox setup in one glance by using `list_mailboxes` to organize your requests. - You can pull up customer profiles and history in seconds by using `get_customer` to find the right data. - You can change ticket owners and statuses quickly by using `update_conversation` to manage your workflow. - You can keep track of your support team members easily by using `list_users` to see who is available. ## How It Works The bottom line is your AI agent gets direct access to your helpdesk actions without the manual clicking. 1. Subscribe to the FreeScout MCP on Vinkius. 2. Add your FreeScout API Key and Base URL to your configuration. 3. Start asking your agent to handle tickets and customers in your helpdesk. ## Frequently Asked Questions **How can I use FreeScout MCP to handle customer tickets?** You can use your AI client to list conversations, summarize long threads, and update ticket statuses without clicking through the helpdesk UI. **Can the FreeScout MCP send replies to my customers?** Yes, your agent can send direct replies to customers. You just need to tell your agent what to say, and it will handle the rest. **How does FreeScout MCP help my support team work faster?** It removes the need to manually copy-paste data between tabs. Your team can stay in their AI workspace to draft replies and manage tickets. **Can I manage my team members using FreeScout MCP?** Yes, you can list all users and agents in your system to keep track of who is active and who is assigned to specific tasks. **Does FreeScout MCP work with my existing helpdesk setup?** It connects directly to your existing FreeScout installation using your API key, so all your current data and mailboxes are included. **Can I use FreeScout MCP to see all my mailboxes at once?** Yes, the Connector can list all your mailboxes, allowing you to quickly see your entire support structure in one view. **How do I reply to a customer conversation using the AI?** You can use the `add_reply` tool. Just provide the Conversation ID and the body of your message, and the agent will send it to the customer via FreeScout. **Can I update the status or assignee of a ticket?** Yes! Use the `update_conversation` tool. You can change the status (active, pending, closed, spam) or provide an `assignee_id` to route the ticket to a specific team member. **Is it possible to add internal notes that the customer won't see?** Absolutely. Use the `add_note` tool to post internal comments on a conversation. These are visible to your team in FreeScout but are never sent to the customer.