How do I find my HetrixTools API Token?

Log in to your HetrixTools account, navigate to **Account Settings**, and click on the **API** tab. You will be able to generate and copy your unique API Token from there.

Can I perform on-demand blacklist checks?

Yes! Use the `check_ip_blacklist` or `check_domain_blacklist` tools. These trigger real-time scans across 90+ blacklists. Note that these requests can take a few minutes to complete.

What are the maintenance modes for monitors?

The integration supports three modes: 1 (Normal), 2 (Maintenance with notifications enabled), and 3 (Maintenance without notifications). Use `set_maintenance_mode` to toggle these.

Is the integration secure for monitoring data?

Absolutely. The integration uses industry-standard Bearer tokens (v3) or secure URL tokens over HTTPS. Your credentials are encrypted and stored securely within the Vinkius Cloud infrastructure.

HetrixTools MCP Server for OpenAI Agents SDK 11 tools — connect in under 2 minutes

Name: HetrixTools
Availability: InStock
Author: Vinkius

openai.github.io/openai-agents-python/mcp

Built by Vinkius GDPR 11 Tools SDK

The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect HetrixTools through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    # Your Vinkius token. get it at cloud.vinkius.com
    async with MCPServerStreamableHttp(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as mcp_server:

        agent = Agent(
            name="HetrixTools Assistant",
            instructions=(
                "You help users interact with HetrixTools. "
                "You have access to 11 tools."
            ),
            mcp_servers=[mcp_server],
        )

        result = await Runner.run(
            agent, "List all available tools from HetrixTools"
        )
        print(result.final_output)

asyncio.run(main())

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About HetrixTools MCP Server

Connect your HetrixTools account to any AI agent and take full control of your infrastructure monitoring and IP reputation management through natural conversation.

The OpenAI Agents SDK auto-discovers all 11 tools from HetrixTools through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries HetrixTools, another analyzes results, and a third generates reports, all orchestrated through Vinkius.

What you can do

Uptime Oversight — List all uptime monitors, check status, and retrieve detailed availability reports for your websites and services.
Blacklist Monitoring — List and manage monitors for IP addresses and domains across 90+ global blacklists.
On-Demand Checks — Perform real-time blacklist scans for any IPv4 address or domain directly from the chat.
Maintenance Control — Quickly toggle maintenance modes for your monitors to avoid false alerts during updates.
Resource Tracking — Monitor your account's API and monitor usage to stay within your plan limits.
Team Alerts — Access and manage your contact lists to ensure the right people are notified of outages.

The HetrixTools MCP Server exposes 11 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect HetrixTools to OpenAI Agents SDK via MCP

Follow these steps to integrate the HetrixTools MCP Server with OpenAI Agents SDK.

Install the SDK

Run pip install openai-agents in your Python environment

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.com

Run the script

Save the code above and run it: python agent.py

Explore tools

The agent will automatically discover 11 tools from HetrixTools

Why Use OpenAI Agents SDK with the HetrixTools MCP Server

OpenAI Agents SDK provides unique advantages when paired with HetrixTools through the Model Context Protocol.

Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety

Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure

Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate

First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output

HetrixTools + OpenAI Agents SDK Use Cases

Practical scenarios where OpenAI Agents SDK combined with the HetrixTools MCP Server delivers measurable value.

Automated workflows: build agents that query HetrixTools, process the data, and trigger follow-up actions autonomously

Multi-agent orchestration: create specialist agents. one queries HetrixTools, another analyzes results, a third generates reports

Data enrichment pipelines: stream data through HetrixTools tools and transform it with OpenAI models in a single async loop

Customer support bots: agents query HetrixTools to resolve tickets, look up records, and update statuses without human intervention

HetrixTools MCP Tools for OpenAI Agents SDK (11)

These 11 tools become available when you connect HetrixTools to OpenAI Agents SDK via MCP:

add_uptime_monitor

Pass the configuration as a JSON string in "body_json" (requires type, target, label, and contact ID). Create a new uptime monitor

check_domain_blacklist

Useful for identifying mail delivery issues. Perform an on-demand blacklist check for a domain

check_ip_blacklist

Note: results may take a few minutes to process. Perform an on-demand blacklist check for an IPv4 address

delete_uptime_monitor

Remove an uptime monitor

get_account_usage

Retrieve current API and resource usage statistics

list_blacklist_monitors

List all IP and domain blacklist monitors

list_bulk_reports

List all generated bulk reports

list_contact_lists

List notification contact lists

list_uptime_monitors

Use this to check the current health of your infrastructure. List all uptime monitors

list_uptime_reports

Retrieve detailed uptime reports for a monitor

set_maintenance_mode

Modes: 1 (Normal), 2 (Maint. with notifications), 3 (Maint. without notifications). Toggle maintenance mode for an uptime monitor

Example Prompts for HetrixTools in OpenAI Agents SDK

Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with HetrixTools immediately.

"List all my uptime monitors and their current status."

"Check if the IP address 1.2.3.4 is blacklisted."

"Put monitor ID 'm123' into maintenance mode without notifications."

Troubleshooting HetrixTools MCP Server with OpenAI Agents SDK

Common issues when connecting HetrixTools to OpenAI Agents SDK through the Vinkius, and how to resolve them.

MCPServerStreamableHttp not found

Ensure you have the latest version: pip install --upgrade openai-agents

Agent not calling tools

Make sure your prompt explicitly references the task the tools can help with.

HetrixTools + OpenAI Agents SDK FAQ

Common questions about integrating HetrixTools MCP Server with OpenAI Agents SDK.

How does the OpenAI Agents SDK connect to MCP?

Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.