HappyFox MCP. Manage tickets and contacts conversationally.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
HappyFox automates support ticketing and help desk management. Connect your entire customer service workflow to any AI agent to manage tickets, search history, and staff updates conversationally.
List tickets, create new support requests, and update cases without leaving your chat window. It gives your AI client the full power of your help desk database.
What your AI agents can do
Add staff update
Adds a staff response or update note to a specific support ticket.
Create ticket
Creates a new support ticket, requiring a subject, text, category ID, and contact details.
Get ticket
Retrieves all detailed information for a single, specified ticket.
List, search, and retrieve detailed information for any support ticket.
Generate and submit a brand new support ticket, requiring a subject, text, category, and contact details.
Add staff responses and updates directly to a specific ticket record.
List and search for existing customer contacts within the help desk database.
Retrieve lists of available categories, statuses, priorities, and staff members to ensure correct ticket routing.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
HappyFox MCP Server: 10 Tools for Support Operations
Use these tools to list, create, search, and manage every element of your support workflow, from contacts to ticket statuses.
019d75aeadd staff update
Adds a staff response or update note to a specific support ticket.
019d75aecreate ticket
Creates a new support ticket, requiring a subject, text, category ID, and contact details.
019d75aeget ticket
Retrieves all detailed information for a single, specified ticket.
019d75aelist categories
Lists every ticket category available in the help desk system.
019d75aelist contacts
Lists all customer contacts stored in the help desk database.
019d75aelist priorities
Lists all available priority levels for tickets.
019d75aelist staff
Lists all staff members currently registered in the system.
019d75aelist statuses
Lists every ticket status available for management.
019d75aelist tickets
Lists all support tickets, allowing filtering and pagination via query parameters.
019d75aesearch tickets
Searches the entire ticket history using a general text query.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with HappyFox, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
You can manage your whole support desk right from your chat window. This server gives your AI client the full power of your HappyFox help desk, letting it handle everything from finding old tickets to adding staff notes. You'll never have to leave the chat to manage a customer issue.
To manage tickets, your AI client can list all support tickets, search through the entire ticket history using a general text query, and pull up detailed information for any single ticket. You can also generate and submit a brand new support ticket, which requires a subject, text, category ID, and contact details.
You'll find it can update a specific ticket by adding staff responses or update notes directly to the record.
It helps you find contacts by listing all customer contacts stored in the help desk database. You can check system data by getting lists of available ticket categories, statuses, priorities, and staff members. Listing these categories, statuses, priorities, and staff members helps you make sure any ticket gets routed correctly.
It's built to handle the whole lifecycle of a support case. Your agent can list tickets, search history, create new requests, and update cases without opening the HappyFox interface.
How HappyFox MCP Works
- 1 Subscribe to the HappyFox server and provide your API Key, Auth Code, and Account Name.
- 2 Tell your AI client the action you need (e.g., 'Find all billing tickets from last month').
- 3 The agent executes the required tools, pulling the data and presenting the results back to you.
The bottom line is, your AI client manages your help desk directly, treating it like a conversational database.
Who Is HappyFox MCP For?
Support Managers who need instant reports without opening a dashboard. Customer Success teams that need to check a client's full support history during a follow-up call. IT Support Staff who need to automate the creation and tracking of internal technical tickets, minimizing manual data entry.
Retrieves ticket statuses, checks staff workloads, and lists ticket categories to ensure proper team coverage.
Checks client support history and adds follow-up updates directly to the ticket record during a client call.
Creates and tracks internal technical tickets, ensuring required contact and category details are captured immediately.
What Changes When You Connect
- You can instantly retrieve ticket statuses and staff workloads using
list_ticketsorlist_staff, eliminating the need to dig through complex reports. - Keep client records current by adding staff updates directly to the case using
add_staff_update. The customer sees the note in their portal, and the ticket history is accurate. - Start a new support case instantly. Use
create_ticketand simply provide the subject, body, and contact details; the agent handles the routing. - You don't have to guess how to categorize. Run
list_categoriesorlist_statusesfirst. The agent provides the full list, ensuring your ticket is routed correctly. - Finding a specific case is fast. Use
search_ticketsto run a text search across your whole ticket history, skipping through irrelevant dashboards. - The agent can list all contacts via
list_contacts, so you never have to copy/paste a customer's email or ID manually.
Real-World Use Cases
A client calls with an obscure error.
The client is confused about a bug and needs help. Instead of asking the agent to manually open a ticket, you tell your agent to run create_ticket with the details. The agent finds the correct category using list_categories and submits the case instantly, getting you a ticket ID.
The team needs to check client history.
A Customer Success Specialist is on a follow-up call and needs to know everything about the client's past issues. They ask the agent to run get_ticket by ID, pulling the full history and all staff notes, which they can then summarize for the client.
Staff member needs to update a case.
A technician resolves a bug and needs to log their findings. They tell the agent to use add_staff_update on ticket ID 456, including all technical details. This updates the record and lets the customer know the issue is resolved.
Finding a specific staff member's role.
The Support Manager needs to know who owns a specific type of ticket. They ask the agent to run list_staff to see the full roster and roles, allowing them to assign the ticket to the right person immediately.
The Tradeoffs
Manual dashboard navigation
The support rep has to click 'Tickets' > 'Filter by Status: Pending' > 'Filter by Category: Billing' > 'Search' and then copy the ID. This takes time and introduces human error.
→
Instead, tell your agent: 'List all pending billing tickets.' The agent runs list_tickets and filters the results using the query parameters, giving you the list and IDs in one step.
Forgetting required ticket fields
The user tries to run create_ticket but forgets to specify the contact's email or the correct category ID. The system fails, and the user has to restart the whole process.
→
Ask the agent to first run list_categories to verify the correct ID, and then run create_ticket with all three required pieces of data: subject, text, and the confirmed category ID.
Searching without context
Running a vague search like 'login' and getting thousands of results. You can't tell which result is the most current or relevant ticket.
→
Start by running search_tickets but immediately add filters. For example: 'Search for 'login' issues, only in the last 7 days, and status 'Open'.' This narrows the scope and gets you usable data.
When It Fits, When It Doesn't
Use this if your primary bottleneck is the speed of human interaction with your ticketing system. If your team spends more time navigating tabs, copying IDs, or manually updating cases than they do solving problems, this server helps. Don't use it if you just need a simple list of names—list_staff is better for that. Also, if your process requires complex, multi-system workflows (e.g., 'Check ERP status, then create ticket, then send Slack message'), you'll need a dedicated workflow engine, not just these API calls. This server is for managing the state of the ticket itself.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by HappyFox. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Managing support tickets shouldn't involve opening five different tabs.
Today, updating a client case means jumping between the main ticket view, the contact profile tab, the internal notes section, and sometimes a separate status dashboard. You have to copy the ID, switch tabs, find the correct form, and make sure you're in the right section. It's clicking fatigue.
With the HappyFox MCP Server, your agent handles the handoffs. You tell it, 'Update ticket 123.' The agent runs `add_staff_update` and logs the note immediately, visible to the client, without you touching a single tab.
HappyFox MCP Server: Control ticket creation and status updates.
Before this server, creating a ticket meant manually finding the correct category ID, verifying the contact email, and filling out multiple required fields on a complex form. If you missed one field, the ticket was rejected, and you had to start over.
Now, the agent runs `create_ticket`. You provide the natural language details, and the agent handles the validation and structured submission process. It just works.
Common Questions About HappyFox MCP
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.
How do I use the `list_contacts` tool to verify user details? +
You use list_contacts to retrieve a comprehensive list of all user records. This allows your agent to confirm a user's name, email, or account status before creating a ticket or adding an update.
What is the best way to handle tickets that require follow-up actions using `get_ticket`? +
After using get_ticket, your agent can review the ticket history for required next steps. You can then use add_staff_update to log internal notes or set a follow-up reminder for the team.
Does the HappyFox server manage ticket priorities when I use `create_ticket`? +
Yes, you specify the priority when calling create_ticket. The tool accepts inputs for priority, ensuring the ticket is routed immediately to the correct team based on urgency.
If a search yields no results, what should the AI agent do using `search_tickets`? +
If search_tickets returns an empty set, the agent should inform the user that no matching tickets were found. It can then suggest expanding the search query or checking different date ranges.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Coda
Combine docs, spreadsheets, and apps into powerful all-in-one documents that grow with your team and automate routine work.
Alegra
Handle your Latin American business accounting with electronic invoicing, expense tracking, and tax-ready financial reports.
LibreChat
Orchestrate your LibreChat instance — manage agents, list available models, and generate AI completions via the Agents and Open Responses APIs.
You might also like
AviationStack Alternative
Real-time flight tracking and global aviation data — monitor flights, routes, airports, and airline schedules directly from any AI agent.
Moneybird
Manage your accounting via Moneybird — list invoices, track contacts, and oversee estimates directly from your AI agent.
Timekit
Embed scheduling into your product with a white-label booking API that handles availability, time zones, and calendar sync.