# HappyFox MCP > HappyFox connects your entire customer service operation directly into any AI agent. Manage tickets, track contacts, and update staff notes without ever leaving your chat window. You get full control over complex help desk workflows—all from natural conversation. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** ticket-management, automated-workflows, customer-service, support-automation, case-tracking, helpdesk ## Description This MCP lets you take the manual work out of managing a support help desk. Instead of clicking through five different tabs to find ticket status, contact history, or category rules, you just talk to your agent. It acts like having a dedicated Support Coordinator on your team. Your agent can check all open tickets, pull up client details by name, and even add staff updates directly to the case file—all without needing an API key or complex commands. You'll find this entire suite of functionality managed through Vinkius, giving you one connection point for thousands of tools across different services. This makes your AI agent a true operational extension of your team. Need to create a new ticket because a client just called? Your agent handles the required subject, text, category ID, and contact details in sequence. Need to know who needs help? You can list contacts or search through entire ticket histories using simple text queries. ## Tools ### add_staff_update Logs a response or update directly into an existing support ticket case. ### create_ticket Generates a brand new support ticket when given the subject, text body, category ID, and contact details. ### get_ticket Pulls complete, detailed information for one specific support case using its ID. ### list_categories Provides a list of all available ticket categories that your team uses. ### list_priorities Shows every possible priority level assigned to a support ticket, from low to high. ### list_staff Retrieves names and roles for all staff members currently using the help desk system. ### list_statuses Lists every current status a ticket can be in, like 'Open' or 'Closed'. ### list_tickets Fetches a comprehensive list of all support tickets using filtering and pagination parameters. ### list_contacts Pulls a list of every user or contact recorded in the help desk system. ### search_tickets Finds relevant tickets by running a general text search across the entire ticket history. ## Prompt Examples **Prompt:** ``` List all pending tickets in the 'General' category. ``` **Response:** ``` I've retrieved your tickets. You have 4 pending items in 'General', including 'Login issue' (ID: 102), 'Billing question' (ID: 105), and 'API feedback' (ID: 110). Which one would you like to update? ``` **Prompt:** ``` Add a staff update to ticket ID 102: 'Looking into this now'. ``` **Response:** ``` Update added! I've successfully logged your response to ticket 102. The customer will be able to see this in their support portal. Would you like to change the ticket status to 'In Progress'? ``` **Prompt:** ``` Create a new ticket for 'App crash on startup' in the Technical category. ``` **Response:** ``` Process started! I found the 'Technical' category (ID: 5). To create the ticket, I'll need the customer's name and email address. Could you provide those? ``` ## Capabilities ### Search support tickets by keywords Your agent searches the entire history of cases for specific words or topics. ### Check all open service requests It pulls a list of all support tickets, allowing you to filter and see what needs attention. ### Pull details on one ticket case You can get comprehensive information about any specific support ticket ID. ### Add responses to an active ticket It lets you log a staff update or response directly into the case file for the customer to see. ### Find and list customer records The agent searches and lists all existing contacts in your help desk database. ### Start a new support ticket You can create an entirely new ticket by providing the subject, body text, category, and contact information. ## Use Cases ### Handling an Escalation A high-priority client calls about a recurring bug. Instead of opening the manual search panel, you ask your agent to `search_tickets` for their name and 'bug'. The agent pulls up all related history so you can address them immediately. ### Onboarding New Staff A new team member needs access to the system. You use your agent to `list_staff` to see who is currently set up and then check ticket categories using `list_categories` to understand workflow rules. ### The Daily Huddle At morning standup, you ask: 'Show me all pending tickets in the General category.' Your agent uses `list_tickets` to pull a filtered list of items that need attention right now. ## Benefits - Stop manually compiling reports. Instead of digging through dashboards to find ticket statuses, your agent lists all tickets instantly. Need to check the status or list details for a specific case? - Keep clients in the loop without copy-pasting. Use the `add_staff_update` tool to log responses directly into the ticket file, ensuring customers see real-time updates. - Never start from scratch. If you need to create a new support request, your agent handles the required subject, text, category ID, and contact details with just a few prompts using `create_ticket`. - Get full visibility on who needs help. You can use `list_contacts` to find customer records or run `search_tickets` to trace every historical interaction across all clients. - Streamline internal coordination. Need to know who's available? Use `list_staff` to get a roster of your team members and their assigned roles in seconds. ## How It Works The bottom line is, you get to talk to your support desk system using natural language instead of navigating complex dashboards. 1. Subscribe to this MCP on Vinkius and enter your HappyFox API Key, Auth Code, and Account Name. 2. Connect your agent client (like Claude or Cursor) to the MCP via your profile settings. 3. Start by asking your agent a question like, 'List all pending tickets in the billing category.' and watch it pull the data for you. ## Frequently Asked Questions **How does HappyFox MCP help me list tickets?** You use the `list_tickets` tool to pull a comprehensive list of all open support requests. You can also run `search_tickets` if you're looking for something specific in the history. **Can HappyFox MCP create new tickets?** Yes, using the `create_ticket` tool. Just give your agent the subject, the text body, and the category details, and it builds the entire record for you. **Is listing categories part of HappyFox MCP?** Yes, the `list_categories` tool lets you see every available ticket category. This is critical when you need to create a new case correctly. **What if I just want to check client information with HappyFox MCP?** Use the `list_contacts` tool. It pulls all existing users in your help desk database, so you can quickly verify who is associated with a ticket. **How do I log notes using HappyFox MCP?** You use the `add_staff_update` tool to record notes. You just tell your agent what update you want, and it logs it directly into the appropriate ticket.