How to Use the HappyFox MCP in CrewAI

Q: How do I pass the HappyFox MCP Server to a CrewAI agent?

Add the Vinkius URL directly to the agent's mcps list during initialization. This instantly exposes tools like createticket to the MCP client. The agent will invoke them as needed to complete its tasks.

Q: Can multiple CrewAI agents collaborate on a HappyFox ticket?

Yes, one agent can use getticket to analyze the issue while another uses addstaffupdate to post the resolved status. CrewAI manages the shared memory so both agents stay aligned. This prevents conflicting updates on the same ticket.

Q: How do I search for specific customer issues using HappyFox and CrewAI?

Your research agent can call searchtickets with a raw text query to find past resolutions. This allows the crew to reuse successful troubleshooting steps for similar new issues. It ensures consistent support quality across your entire queue.

Q: Can I limit which tools an agent can access?

Yes, you can use toolfilter in your CrewAI setup to restrict access to sensitive tools. This ensures an agent can read tickets but cannot modify them without authorization.

Q: How is my internal staff data protected?

Your staff roster retrieved via liststaff is never stored or cached by Vinkius. The MCP Server executes in an ephemeral V8 sandbox, passing the data directly to your local CrewAI process and immediately wiping the execution state.

Deploy a crew of autonomous AI agents to manage your HappyFox support queue.

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 CrewAI

Create your Vinkius account to connect HappyFox to CrewAI 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 CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Let specialized agents triage your queue

`list_tickets` allows your triage agent to scan the incoming queue and identify urgent customer issues. A separate analyst agent then processes the ticket details to determine the root cause of the problem. This collaborative approach ensures thorough investigation before any action is taken. Your support team only steps in when a complex issue requires human empathy.

CrewAI agents resolve common support issues

`add_staff_update` lets your response agent post solutions to common customer questions directly. The agent pulls troubleshooting steps from your internal docs and updates the ticket without manual typing. This cuts down your response times significantly. Your human staff can focus on deep technical issues while the crew handles repetitive tier-one requests.

Categorize tickets using an MCP Server

`list_categories` retrieves your help desk structure so your CrewAI agents can classify incoming tickets accurately. The agent reads the customer's message and assigns the correct category ID. This keeps your help desk organized from the moment a ticket arrives. You avoid the chaos of misrouted tickets and manual reassignment loops.

Setup guide

Set up HappyFox MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke HappyFox tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="HappyFox Analyst",
    goal="Access and analyze HappyFox data via MCP.",
    backstory="Expert analyst with direct HappyFox access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent HappyFox transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="HappyFox Analyst",
        goal="Access and analyze HappyFox data via MCP.",
        backstory="Expert analyst with direct HappyFox access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent HappyFox transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

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 CrewAI

Add the Vinkius URL directly to the agent's `mcps` list during initialization. This instantly exposes tools like `create_ticket` to the MCP client. The agent will invoke them as needed to complete its tasks.

Yes, one agent can use `get_ticket` to analyze the issue while another uses `add_staff_update` to post the resolved status. CrewAI manages the shared memory so both agents stay aligned. This prevents conflicting updates on the same ticket.

Your research agent can call `search_tickets` with a raw text query to find past resolutions. This allows the crew to reuse successful troubleshooting steps for similar new issues. It ensures consistent support quality across your entire queue.

Yes, you can use `tool_filter` in your CrewAI setup to restrict access to sensitive tools. This ensures an agent can read tickets but cannot modify them without authorization.

Your staff roster retrieved via `list_staff` is never stored or cached by Vinkius. The MCP Server executes in an ephemeral V8 sandbox, passing the data directly to your local CrewAI process and immediately wiping the execution state.

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