How to Use the HetrixTools MCP in Pydantic AI

Q: How do I initialize the HetrixTools MCP Server in Pydantic AI?

Install pydantic-ai-slimmcp. Create an MCPToolset pointing to your HTTP endpoint. Pass this toolset directly to your Agent constructor.

Q: Can Pydantic AI manage HetrixTools maintenance modes?

Yes. The agent executes setmaintenancemode to toggle alerting states. It passes an integer from 1 to 3 to control whether notifications fire during your scheduled downtime.

Q: How do I check my HetrixTools API limits through Pydantic AI?

Your agent calls getaccountusage to pull current resource statistics. Pydantic validates the usage counters, allowing your code to safely halt operations if you approach your billing cap.

Q: What happens if I want to delete a monitor?

The agent uses deleteuptimemonitor to remove the node. You define strict guardrails in your Pydantic schema to ensure the agent only deletes nodes matching specific criteria.

Bring strict type validation to your HetrixTools infrastructure using Pydantic AI.

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 Pydantic AI

Create your Vinkius account to connect HetrixTools to Pydantic AI 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 Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate monitor states in Pydantic AI

The `list_uptime_monitors` MCP tool fetches the current health of your entire infrastructure. Pydantic AI validates every field in the response against your defined schemas. If HetrixTools returns a missing status flag, the agent fails loudly instead of hallucinating a healthy server. You can dig deeper into specific outages. The agent calls `list_uptime_reports` to pull detailed historical logs. Because the data is strictly typed, your downstream Python code handles the metrics without throwing unexpected parsing errors.

Verify IP reputation securely

The `check_ip_blacklist` tool triggers an on-demand scan for any IPv4 address. Your agent requests the scan, and Pydantic AI ensures the resulting data structure perfectly matches your expectations. You get hard facts about your mail server reputation. For domain-level issues, the agent runs `check_domain_blacklist`. If the domain is flagged, the agent parses the exact spam databases involved. You never have to guess why your transactional emails are bouncing.

Deploy monitors via MCP Server

The `add_uptime_monitor` tool creates new tracking nodes. Your agent constructs a strict JSON payload containing the required type, target, label, and contact ID. If the payload is malformed, Pydantic catches it before the API request ever fires. To find the right contact ID, the agent first runs `list_contact_lists`. It grabs the valid IDs, maps them to the new monitor configuration, and executes the deployment. It is a completely deterministic provisioning pipeline.

Setup guide

Set up HetrixTools MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "hetrixtools-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to HetrixTools tools.",
)

result = await agent.run("List recent HetrixTools transactions")
print(result.output)

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 Pydantic AI

Install `pydantic-ai-slim[mcp]`. Create an `MCPToolset` pointing to your HTTP endpoint. Pass this toolset directly to your Agent constructor.

Yes. The agent executes `set_maintenance_mode` to toggle alerting states. It passes an integer from 1 to 3 to control whether notifications fire during your scheduled downtime.

Your agent calls `get_account_usage` to pull current resource statistics. Pydantic validates the usage counters, allowing your code to safely halt operations if you approach your billing cap.

The agent uses `delete_uptime_monitor` to remove the node. You define strict guardrails in your Pydantic schema to ensure the agent only deletes nodes matching specific criteria.

This MCP integration interacts with your internal server labels, IPv4 addresses, and uptime percentages. Vinkius isolates the connection in a secure V8 sandbox, guaranteeing your network topology remains private and ephemeral.

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