# HetrixTools MCP

> HetrixTools lets you monitor critical infrastructure health and manage IP reputation using natural conversation. Check the uptime of websites, list all monitors for a service, or scan any domain against 90+ global blacklists directly from your AI agent. It gives system admins real-time visibility into both availability and digital standing.

## Overview
- **Category:** cloud-infrastructure
- **Price:** Free
- **Tags:** uptime-monitoring, blacklist-checking, server-health, ip-reputation, availability-reports, network-monitoring

## Description

Connect this MCP to your preferred AI client, and you get instant control over monitoring infrastructure health and managing IP reputation without logging into a dashboard. You can ask your agent to check if a specific website is up right now or generate detailed reports on service history. If you're worried about mail delivery issues, you just ask it to run an on-demand blacklist scan for a domain. Need to know if an IP address got flagged anywhere? It handles that too, checking against dozens of global blacklists. This capability means your agent acts like a dedicated system administrator or DevOps engineer. When combined with the Vinkius catalog, you access all this deep infrastructure data from one place, letting your AI client do the heavy lifting so you don't have to manually check dashboards.

## Tools

### add_uptime_monitor
Creates a brand new scheduled monitor to check the availability of a website or endpoint.

### check_domain_blacklist
Performs an immediate blacklist scan specifically for checking if a domain name is flagged.

### check_ip_blacklist
Runs an on-demand check to see if an IPv4 address is listed on any blacklists.

### delete_uptime_monitor
Removes an existing uptime monitor from your list of scheduled checks.

### get_account_usage
Retrieves statistics on how much API and resource usage you've consumed for the month.

### list_blacklist_monitors
Shows all the IP address and domain name monitors currently set up to track blacklisting status.

### list_bulk_reports
Lists every comprehensive bulk report that has been generated by the system.

### list_contact_lists
Retrieves a list of contact groups used for sending out outage notifications.

### list_uptime_monitors
Lists all the scheduled uptime checks and their current health status to give an overview of your services.

### list_uptime_reports
Fetches detailed, historical reports for a specific monitor ID showing its past performance.

### set_maintenance_mode
Toggles an uptime monitor into maintenance mode (Normal, Maint. w/ notifications, or Maint. without notifications).

## Prompt Examples

**Prompt:** 
```
List all my uptime monitors and their current status.
```

**Response:** 
```
I've retrieved your monitors. You have 5 active checks: 'Primary Website' (Up), 'API Endpoint' (Up), 'DB Server' (Up), 'Mail Gateway' (Up), and 'Staging Site' (Down - since 5 mins ago). Would you like to see the error log for the Staging Site?
```

**Prompt:** 
```
Check if the IP address 1.2.3.4 is blacklisted.
```

**Response:** 
```
Blacklist check initiated for 1.2.3.4. I've scanned 94 global blacklists. The IP is currently CLEAN (0/94 listings). Would you like to add this IP to your permanent blacklist monitors?
```

**Prompt:** 
```
Put monitor ID 'm123' into maintenance mode without notifications.
```

**Response:** 
```
Maintenance mode updated! Monitor m123 is now in mode 3 (Maintenance without notifications). You can perform your updates without triggering any alerts. Should I list your other monitors?
```

## Capabilities

### Check service availability
The agent lists existing uptime checks and runs real-time tests on websites or services.

### Validate IP and domain reputation
It performs on-demand blacklist scans against global blacklists for any given IPv4 address or domain name.

### Manage monitoring reports
You can retrieve detailed availability history, list all generated bulk reports, and check your account's usage limits.

### Control maintenance modes
The agent toggles a monitor into specific maintenance states so you can perform updates without triggering false alerts.

## Use Cases

### Post-deployment verification
The DevOps Engineer just pushed a new version. They ask their agent to list uptime monitors and then use set_maintenance_mode on all endpoints, ensuring no one gets alerted while they test the rollout. Once done, they restore the monitors.

### Investigating mail bounces
A user is getting constant bounce messages. They ask their agent to check_domain_blacklist for the domain in question. The agent scans 90+ lists and reports back if it's flagged, saving hours of manual research.

### Quarterly audit prep
The System Administrator needs proof that their main API endpoint has been stable for the last quarter. They ask the agent to list_uptime_reports and retrieve a comprehensive report showing minimal downtime.

### Pre-launch risk assessment
A Website Owner is about to launch a major service change. Before they commit, they use check_ip_blacklist on their primary IP address to verify it has zero negative reputation listings anywhere globally.

## Benefits

- Real-time status checks: Instead of checking a dashboard, you just ask your agent to list uptime monitors and get an immediate summary of what's working and what isn't.
- Deep blacklist validation: You don't have to visit separate services; the agent runs on-demand blacklists for both IP addresses and domains across 90+ global lists in one go.
- Control monitoring alerts: Need to update a site? Use set_maintenance_mode to put a monitor into maintenance mode, guaranteeing you won't get false outage alerts during deployment.
- Comprehensive reporting access: You can list all generated bulk reports and check historical data using list_uptime_reports, giving you proof of service stability when needed.
- Resource awareness: The tool provides get_account_usage, so you always know how much API quota you've burned. No unexpected bill shocks.
- Team coordination: Manage notification systems by listing contact lists, ensuring outage alerts go to the right people every time.

## How It Works

The bottom line is, you use natural language conversation instead of clicking through complex monitoring dashboards.

1. First, subscribe to this MCP and provide your HetrixTools API Token in the account settings.
2. Next, prompt your AI agent with a request, like 'Check the status of my primary website' or 'Scan 192.168.1.1 for blacklisting'.
3. Your agent uses the tool to run the check and delivers a plain-language summary of the service health or blacklist result directly into your chat.

## Frequently Asked Questions

**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.