# HappyFox MCP for AI Agents AI Agent Connect > HappyFox MCP lets you manage your entire help desk directly through your AI agent. You can create tickets, update staff notes, search your customer database, and organize categories without leaving your chat interface. It turns your agent into a support coordinator that handles the heavy lifting of ticket lifecycle management. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_I7arE6jBK6WWEsAwUe8piYUWXpwHZXgcaQ8cHyGb/ai-agent-connect - **Tags:** ticket-management, automated-workflows, customer-service, support-automation, case-tracking, helpdesk ## Description The HappyFox MCP connects your help desk to any AI agent so you can manage customer support workflows through natural conversation. Imagine you're buried in support tickets and have to keep switching tabs between your chat and your help desk dashboard. This setup changes that. Instead of manually clicking through folders to find a specific request, you can just ask your agent to pull up the latest issues or search for a specific customer's history. It handles the grunt work like logging new requests with the right category labels and updating staff notes so the rest of the team stays in the loop. When you connect this to your workflow via the Vinkius catalog, your AI client stops being a chatbot and starts acting like a dedicated support coordinator. You can check staff workloads, list out priorities, and keep your database organized by just talking to your agent. It's about getting rid of the copy-paste cycle between your communication tools and your ticketing system. ## Tools ### list_categories See all your help desk categories. This helps your agent route tickets correctly. ### list_contacts See all customers in your database. Use this to find contact info quickly. ### add_staff_update Add a response or note to a ticket. This keeps your team updated on the latest progress. ### create_ticket Create a new support request with a subject and category. This automates the manual entry of new issues. ### get_ticket Fetch every detail about a specific ticket. Use this to see the full history of a customer's problem. ### list_priorities View all available ticket priorities. Use this to understand how to rank different issues. ### list_staff See all staff members and their roles. This is great for checking who is on duty. ### list_statuses Get a list of all ticket statuses. Use this to filter for pending or resolved items. ### list_tickets List all support tickets with filters. This gives you a high-level view of your current queue. ### search_tickets Search for tickets using a text query. This lets you find specific issues in seconds. ## Prompt Examples **Prompt:** ``` List all pending tickets in the 'Billing' category. ``` **Response:** ``` I've pulled up the pending tickets for the Billing category: | Ticket ID | Subject | Priority | | :--- | :--- | :--- | | 402 | Invoice not received | High | | 405 | Refund request | Medium | | 409 | Update billing cycle | Low | Would you like me to update any of these for you? ``` **Prompt:** ``` Add a staff update to ticket ID 105: 'Customer confirmed the password reset worked'. ``` **Response:** ``` I've added that update to ticket 105. The internal team can now see that the password reset was successful. Should I mark this ticket as resolved? ``` **Prompt:** ``` Create a new ticket for 'Slow dashboard loading' for user jane@example.com. ``` **Response:** ``` I'm ready to create that ticket for you. I've identified the 'Technical' category. Could you please provide a subject line for this issue? ``` ## Capabilities ### Create support tickets Log new help desk requests with specific subjects and categories. ### Update staff notes Add responses and internal updates to existing tickets. ### Search ticket history Find specific cases across your entire history using text queries. ### List active tickets View your current queue with filtering for statuses and priorities. ### Manage customer contacts Retrieve and search for customer records in your database. ### Retrieve staff roles Get a list of all staff members and their assigned positions. ## Use Cases ### High Volume Spikes A support lead asks the agent to list all pending tickets in a specific category to see what needs immediate attention. ### Live Client Follow-ups A success rep asks the agent to add a staff update to a ticket while on a call with a customer to log the conversation. ### Onboarding New Issues An IT staffer tells the agent to create a ticket for a reported crash, providing the customer details via chat. ### Staff Workload Checks A manager asks the agent to list all staff members to see who is available to take on new high-priority cases. ## Benefits - Stop switching tabs between your chat and HappyFox by using list_tickets to see your queue instantly. - Update your team in real-time using add_staff_update to keep everyone on the same page without manual typing. - Speed up new request intake by having your agent use create_ticket to log issues as they happen. - Find customer info faster by using list_contacts to pull up history while you're talking to a client. - Keep your queue organized by using list_categories and list_statuses to ensure every request goes to the right person. - Save time on manual searches by using search_tickets to find specific keywords across your entire history. ## How It Works The bottom line is your help desk becomes a conversational interface for faster ticket handling. 1. Subscribe to the HappyFox MCP on Vinkius. 2. Enter your HappyFox API Key, Auth Code, and Account Name in the configuration. 3. Start asking your agent to list tickets, create requests, or update staff notes. ## Frequently Asked Questions **Can I use the HappyFox MCP to manage my help desk?** Yes, it lets you list, create, and update tickets directly through your AI agent. You can manage your entire support queue without leaving your chat app. **Does the HappyFox MCP support searching old tickets?** Yes, you can use the search tool to find specific keywords across your entire ticket history. This makes it easy to find past resolutions for returning customers. **How does the HappyFox MCP help with staff updates?** It allows your agent to add notes to tickets, keeping your team informed without manual entry. You can just tell your agent what happened, and it logs the note. **Can I use HappyFox MCP to see my customer list?** Yes, your agent can pull up and search through your contact database to find customer info. This helps you quickly identify who you're talking to during a support call. **Can the HappyFox MCP create new tickets for me?** Yes, you can give your agent the customer details and a subject to log a new request automatically. It handles the data entry for you in real-time. **Will the HappyFox MCP help me organize my ticket categories?** Yes, your agent can access your categories and statuses to help route tickets correctly. This ensures that requests get to the right team members faster. **How do I find my HappyFox API credentials?** Log in to HappyFox, go to **Manage > Integrations > API**. You will be able to generate your **API Key** and **Auth Code** from there. **What is the 'Account Name'?** The Account Name is the subdomain used to access your HappyFox instance (e.g., if you log in at `company.happyfox.com`, your account name is `company`). **Can I add updates to existing tickets?** Yes! Use the `add_staff_update` tool. You just need to provide the `ticket_id` and the text of your update. This will appear as a staff response in the help desk. **Is the integration secure for managing support data?** Absolutely. The integration uses industry-standard HTTP Basic authentication over HTTPS. Your credentials are encrypted and stored securely within the Vinkius Cloud infrastructure.