How to Use the HappyFox MCP in Claude Code

Q: Can I list my help desk staff in Claude Code?

Yes, Claude Code calls liststaff to output your team directory to the terminal. You can use this to quickly find staff IDs for ticket assignments or updates.

Q: How does this HappyFox MCP Server handle ticket searches in Claude Code?

This server enables the searchtickets tool within your CLI. You ask Claude Code to find tickets matching a specific keyword, and it returns the matches directly to your terminal screen.

Q: Can I check ticket statuses from my terminal?

Yes, Claude Code uses liststatuses to fetch your current support workflow states. This helps you track whether tickets are open, pending, or closed without leaving your command-line environment.

Manage your HappyFox support queue, update tickets, and script help desk workflows directly from the Claude Code CLI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HappyFox MCP to Claude Code

Create your Vinkius account to connect HappyFox to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup HappyFox with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Query HappyFox via the Claude Code CLI

The `list_tickets` tool lets you fetch, paginate, and filter your active HappyFox issues right from your shell. Claude Code pipes this data into other CLI utilities or processes it directly to show your open workload. You can narrow down your search using `search_tickets` to find specific customer issues without opening a heavy web interface. This HappyFox MCP Server integration keeps your hands on the keyboard.

Terminal-Driven Ticket Updates

The `add_staff_update` tool allows you to post internal notes or customer replies instantly. You tell Claude Code what to write, and it executes the API call to update the thread. Your agent uses `get_ticket` to verify the ticket's current state before posting. This ensures your terminal-based updates are always applied to the correct, active issue.

Map help desk metadata in your terminal

The `list_categories` tool retrieves your ticket categories to help you route new issues from automated shell scripts. Claude Code reads these categories to ensure programmatic tickets are filed correctly. By chaining `list_priorities` and `list_statuses`, you can build automated shell workflows that check queue health. This MCP Server setup gives your terminal agent full visibility into your support architecture.

Setup guide

Set up HappyFox MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see happyfox-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest HappyFox transactions." It will automatically discover and invoke the available HappyFox tools.

Terminal

claude mcp add --transport http happyfox-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the HappyFox MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "happyfox-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect HappyFox now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about HappyFox MCP in Claude Code

You run a command telling Claude Code to file an issue, and it invokes `create_ticket` with your subject, text, category, and contact details. It automatically pulls category IDs using `list_categories` to ensure the ticket is placed correctly.

Yes, Claude Code calls `list_staff` to output your team directory to the terminal. You can use this to quickly find staff IDs for ticket assignments or updates.

This server enables the `search_tickets` tool within your CLI. You ask Claude Code to find tickets matching a specific keyword, and it returns the matches directly to your terminal screen.

Yes, Claude Code uses `list_statuses` to fetch your current support workflow states. This helps you track whether tickets are open, pending, or closed without leaving your command-line environment.

The integration handles ticket messages, staff profiles, and customer contact information. Vinkius runs the MCP Server in an isolated sandbox with single-token authentication, meaning your support credentials and customer queries are never exposed or logged.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript