How to Use the HetrixTools MCP in CrewAI

Q: How do I attach the HetrixTools MCP server to my CrewAI agents?

Install crewaitools. You can pass the Vinkius endpoint directly into the mcps array on your Agent definition, and the framework will automatically load all available functions.

Deploy autonomous agent crews to monitor server uptime and manage HetrixTools IP blacklists.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HetrixTools MCP to CrewAI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous infrastructure auditing

The `list_uptime_monitors` tool gives your CrewAI monitoring agent full visibility into your active endpoints. The agent pulls the entire list of tracked servers and compares it against your current AWS inventory. It holds this state in shared memory for the rest of the crew to access. If the analysis agent finds dead servers that no longer exist in your cloud account, it flags them. The action agent then steps in and calls `delete_uptime_monitor` to clean up the HetrixTools dashboard automatically. No human sysadmin has to manually prune the list.

CrewAI MCP Server reputation defense

Your security agent uses `list_blacklist_monitors` to pull down every IP and domain you currently watch. It reviews the list to ensure all production mail servers are actively tracked. If anything is missing, it alerts the team. When an active threat is detected, a specialized remediation agent runs `check_ip_blacklist` on the affected IPv4 address. Because CrewAI supports hierarchical execution, the manager agent evaluates the blacklist results and decides whether to reroute traffic or contact the ISP.

Dynamic monitor provisioning

Provisioning new infrastructure triggers your CrewAI deployment agent to execute `add_uptime_monitor`. You pass the target IP, monitor type, and contact ID. The agent formats the JSON payload and registers the new server with HetrixTools before the server even finishes booting. To avoid hitting API caps during massive deployments, the manager agent calls `get_account_usage` first. It checks your current resource limits. If you have enough room on your tier, it approves the mass addition of new monitors.

Setup guide

Set up HetrixTools 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 HetrixTools tools as needed.

crew.py

from crewai import Agent, Task, Crew

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

task = Task(
    description="List recent HetrixTools 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="HetrixTools Analyst",
        goal="Access and analyze HetrixTools data via MCP.",
        backstory="Expert analyst with direct HetrixTools access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent HetrixTools 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 HetrixTools. 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 HetrixTools 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 HetrixTools MCP in CrewAI

Install crewai[tools]. You can pass the Vinkius endpoint directly into the mcps array on your Agent definition, and the framework will automatically load all available functions.

Yes. Use MCPServerHTTP from crewai.mcp and configure the tool_filter. This lets you give the monitoring agent read-only tools while restricting deletion tools to the manager agent.

The framework handles the delay naturally. The agent will wait for the API response before passing the blacklist data into the shared memory for the next agent to analyze.

You only need your Vinkius endpoint token. Pass it via environment variables or directly in the connection setup, and the managed server handles the actual HetrixTools API keys.

The agents send target URLs, IPv4 addresses, and contact routing IDs to the MCP server. Vinkius executes these requests inside a strict V8 Isolate sandbox that blocks all external network access except the official HetrixTools API, wiping the memory state completely after each task.

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