Happyfox

io.usefulapiv1.0.0Updated Sep 30, 2026

Triage HappyFox tickets, contacts and KB articles, run reports, and reply or add private notes.

VerifiedStreamable HTTPWeb executableBusiness & CommerceProductivity & Workflow

Overview

AI-generated overview

Lets an assistant read and update HappyFox help-desk tickets, contacts, knowledge-base articles and reports.

What it does
Connects an assistant to a HappyFox help desk through a hosted MCP endpoint. Read tools list or fetch tickets, contacts, contact groups, categories, agents, statuses, priorities, custom fields, reports and knowledge-base articles. Write tools create tickets and contacts, edit contacts, reply to a ticket as an agent, add private notes, and change ticket tags or custom fields. Meta tools report usage and manage the subscription.
When to use it
Useful when support work happens in HappyFox and you want an assistant to triage tickets, look up contacts or KB articles, pull report data, or draft replies and notes without switching to the web UI. Less useful if you do not use HappyFox as your help desk.
Requirements
A remote MCP endpoint; no local install. You supply your HappyFox help-desk subdomain, region, API key and auth code (created under Manage, Integrations, API). Credentials are validated and stored per user rather than in config files. Network access to the endpoint is required.
Before you install
Write tools change live help-desk data: creating tickets and contacts, editing contacts, replying to tickets as an agent, adding private notes, and changing tags or custom fields. Replies and notes may be visible to customers or staff, so confirm before sending. The API key and auth code are sensitive credentials. The free tier allows 100 tool calls per month; Pro is $9 per month or $90 per year per user.

Installation

In SourceWeft

  1. Open Happyfox in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "happyfox": {
      "type": "http",
      "url": "https://happyfox.usefulapi.io/mcp"
    }
  }
}

README

HappyFox MCP by usefulapi

Use HappyFox from Claude, Cursor, or any MCP client — triage tickets, contacts and KB articles, run reports, and reply or add private notes. Hosted, no local install: connect with your own HappyFox credentials.

Live endpoint: https://happyfox.usefulapi.io/mcp · Homepage: https://usefulapi.io/happyfox

Add to Claude

json
{  "mcpServers": {    "happyfox": {      "url": "https://happyfox.usefulapi.io/mcp"    }  }}

On first connect you'll provide your HappyFox help-desk subdomain, region, API key and auth code (Manage → Integrations → API → Create API key). They're validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
happyfox_list_ticketsreadList or search tickets
happyfox_get_ticketreadGet one ticket
happyfox_list_contactsreadList or search contacts
happyfox_get_contactreadGet one contact
happyfox_list_contact_groupsreadList contact groups
happyfox_get_contact_groupreadGet one contact group
happyfox_list_categoriesreadList categories
happyfox_list_staffreadList agents
happyfox_list_statusesreadList statuses
happyfox_list_prioritiesreadList priorities
happyfox_list_ticket_custom_fieldsreadList ticket custom fields
happyfox_list_contact_custom_fieldsreadList contact custom fields
happyfox_list_reportsreadList reports
happyfox_get_report_summaryreadGet a report summary
happyfox_get_report_tabular_datareadGet a report's ticket rows
happyfox_list_kb_articlesreadExport knowledge-base articles
happyfox_create_ticketwriteCreate a ticket
happyfox_add_staff_replywriteReply to a ticket as an agent
happyfox_add_private_notewriteAdd a private note to a ticket
happyfox_update_ticket_tagswriteAdd or remove ticket tags
happyfox_update_ticket_custom_fieldswriteEdit a ticket's custom fields
happyfox_create_contactwriteCreate a contact
happyfox_update_contactwriteEdit a contact
happyfox_usage_statusmetaUsage status (free-tier meter)
happyfox_upgrademetaUpgrade to Pro (unlimited)

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage or manage your subscription.

Pricing

PlanPriceLimit
Free$0100 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited

License

MIT © usefulapi. Not affiliated with or endorsed by HappyFox.

Source: servers/happyfox/README.md at commit 1ec23c2

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.0LatestSep 30, 2026