MCP server

HappyFox MCP by usefulapi

io.usefulapi/happyfox

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

23

Token cost

About 5,994 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http happyfox https://happyfox.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.happyfox]
url = "https://happyfox.usefulapi.io/mcp"

Gemini CLI

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

Cursor

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

VS Code

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

Antigravity

agy mcp add happyfox https://happyfox.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"happyfox","server_url":"https://happyfox.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"happyfox","server_url":"https://happyfox.usefulapi.io/mcp"}

Tools

• happyfox_add_private_note ~686 tokens
  Add an internal note (never sent to the contact), optionally alerting agents and changing status, priority, assignee, due date or tags. HappyFox: POST /api/1.1/json/ticket/<ticket_number>/staff_pvtnote/.
• happyfox_add_staff_reply Sends messages · ~821 tokens
  Add an agent reply to a ticket and/or change its status, priority, assignee, due date or tags. The contact is emailed ONLY if update_customer is true (HappyFox default: false). With no message it just updates properties. Moving to a completed status may require the category's compulsory custom field
• happyfox_create_contact ~520 tokens
  Create a contact. HappyFox treats this as create-or-edit keyed on email: if the email already exists that contact is updated, and any contact custom field NOT passed is reset — use happyfox_update_contact to edit an existing contact. HappyFox: POST /api/1.1/json/users/.
• happyfox_create_ticket ~722 tokens
  Open a new ticket on behalf of a contact (created if the email is new). Needs a category id (a public category), a subject and a message in `text` or `html`. HappyFox: POST /api/1.1/json/tickets/.
• happyfox_get_contact ~126 tokens
  Fetch a contact by id or by email address — phones, contact groups, ticket counts and custom fields. HappyFox: GET /api/1.1/json/user/<id or email>/.
• happyfox_get_contact_group ~115 tokens
  Fetch a contact group and its member contacts. HappyFox: GET /api/1.1/json/contact_group/<id>/.
• happyfox_get_report_summary ~129 tokens
  Summary counts for a saved report: ticket, completed, assigned, pending and unassigned counts. HappyFox: GET /api/1.1/json/report/<id>/.
• happyfox_get_report_tabular_data ~204 tokens
  The tabular view of a saved report — one row per ticket (display_id, subject, status, assignee, due date), paginated. HappyFox: GET /api/1.1/json/report/<id>/tabulardata/.
• happyfox_get_ticket ~214 tokens
  Fetch a ticket with its full conversation: status, priority, category, contact, assignee, custom fields, SLA breaches and every update (messages, private notes, property changes, attachment links that expire in 5 minutes). HappyFox: GET /api/1.1/json/ticket/<ticket_number>/.
• happyfox_list_categories ~84 tokens
  List ticket categories (queues) with their ids — needed to create a ticket or filter tickets. HappyFox: GET /api/1.1/json/categories/.
• happyfox_list_contact_custom_fields ~88 tokens
  List contact custom fields: id, type, choices and required flag. Use the ids as c-cf-<id>. HappyFox: GET /api/1.1/json/user_custom_fields/.
• happyfox_list_contact_groups ~83 tokens
  List contact groups (typically customer companies) with their tagged email domains. HappyFox: GET /api/1.1/json/contact_groups/.
• happyfox_list_contacts ~208 tokens
  List contacts (customers), paginated, or search them. Search `q` fields: name, email, phone (digits only, no +), updated_since, created_since — e.g. `name:adam email:adam@example.com` (space-separated, all must match). HappyFox: GET /api/1.1/json/users/.
• happyfox_list_kb_articles ~127 tokens
  Export the knowledge base: external (customer-facing) articles by default, or internal (agent-only) articles. HappyFox: GET /api/1.1/json/kb/articles/ or /kb/internal-articles/.
• happyfox_list_priorities ~77 tokens
  List ticket priorities with ids — ids used to set a ticket's priority. HappyFox: GET /api/1.1/json/priorities/.
• happyfox_list_reports ~76 tokens
  List the saved reports (id, name, description) from the Reports module. HappyFox: GET /api/1.1/json/reports/.
• happyfox_list_staff ~91 tokens
  List agents (staff) with their ids, roles, categories and active flag — the `staff` id every reply/note needs, and assignee ids. HappyFox: GET /api/1.1/json/staff/.
• happyfox_list_statuses ~86 tokens
  List ticket statuses with ids and behaviour (pending / completed) — ids used to change a ticket's status. HappyFox: GET /api/1.1/json/statuses/.
• happyfox_list_ticket_custom_fields ~97 tokens
  List ticket custom fields: id, type, choices (with choice ids), required flags and categories. Use the ids as t-cf-<id>. HappyFox: GET /api/1.1/json/ticket_custom_fields/.
• happyfox_list_tickets ~533 tokens
  List tickets, newest activity first, with optional filters and HappyFox's search syntax. Paginated (page_info + data). Search `q` examples: `status:"New","In Progress"`, `priority:"High"`, `assignee:none`, `tag:"billing"`, `contact:"jane@example.com"`, `unresponded:true`, `breached:true`, `duedate:o
• happyfox_update_contact ~343 tokens
  Edit an existing contact's name, email or contact custom fields (c-cf-<id>). Phone numbers are edited via happyfox_create_contact with the phone id. HappyFox: POST /api/1.1/json/user/<id>/.
• happyfox_update_ticket_custom_fields ~327 tokens
  Set ticket custom-field values (t-cf-<id>, ids from happyfox_list_ticket_custom_fields). HappyFox: POST /api/1.1/json/ticket/<ticket_number>/update_custom_fields/.
• happyfox_update_ticket_tags ~237 tokens
  Add and/or remove tags on a ticket without touching anything else. HappyFox: POST /api/1.1/json/ticket/<ticket_number>/update_tags/.

Browse

• Email
• Notes and wikis

Related MCP servers

• Trengo MCP by usefulapi
  Work tickets and messages, look up contacts and teams, pull reports, and reply, assign or close.
• Zammad MCP by usefulapi
  Search and read Zammad tickets, customers and organizations; add notes, replies and ticket updates.
• Freshdesk MCP by usefulapi
  Read tickets, contacts, companies, agents and groups; create, update and reply to tickets.
• SupportBee MCP by usefulapi
  Read SupportBee tickets, replies and reports; reply, comment, label, assign and archive tickets.
• Deskpro MCP by usefulapi
  Search tickets, people, organizations and KB articles in Deskpro, and create tickets and replies.
• eDesk MCP by usefulapi
  Work with eDesk support tickets, replies, internal notes, contacts and sales orders.
• Enchant MCP by usefulapi
  Work with Enchant help desk tickets: list, read, reply, add notes and labels, manage customers.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/happyfox.svg)](https://aptlynx.net/servers/io.usefulapi/happyfox)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents