# Hexometer MCP

> Hexometer connects your website monitoring data to any AI agent. It lets you manage technical site health and performance from a simple conversation. Need to check if a page is fast on mobile or identify broken links across dozens of sites? Your AI client runs deep audits, checks historical uptime logs, and validates SSL certificate status—all without you opening a dashboard. Stop manually checking monitoring reports; just ask your agent.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** website-health, page-speed, performance-monitoring, uptime-tracking, technical-seo, asset-analysis

## Description

Tired of logging into multiple dashboards to check if your website is still running smoothly? This MCP lets your AI client act as a dedicated web performance engineer for all your properties. You can ask it to analyze speed, triggering on-demand page tests for both desktop and mobile devices. It pinpoints heavy scripts, large images, or JavaScript errors that slow things down. Need to know if every link works? The agent checks broken links across your domain. Furthermore, you can pull historical uptime statistics or run a full SEO audit against meta tags and headers. If you're looking for an easy way to manage technical web assets through natural conversation, connecting this MCP via Vinkius is the quickest way to get control.

## Tools

### check_broken_links
Finds and lists any detected 404 errors or broken links for a specific web property.

### check_page_errors
Scans an entire page to pinpoint JavaScript errors and heavy assets that impact performance.

### check_speed_desktop
Analyzes the speed score and asset details for a given URL when accessed on a desktop computer.

### check_speed_mobile
Performs an analysis of page load speed specifically for mobile devices, giving you crucial user insight.

### get_site_health
Retrieves the comprehensive overall health score and status report for a specific website property.

### get_security_status
Checks the SSL certificate expiry date and general security posture of a site.

### get_uptime_stats
Provides historical data showing how consistently available a website has been over time.

### list_recent_alerts
Pulls a list of the most recent monitoring alerts and notifications for your monitored sites.

### list_monitored_sites
Generates an inventory by listing all websites (properties) that are currently tracked in Hexometer.

### list_wordpress_syncs
Lists all active WordPress plugin synchronizations running within the system.

### run_seo_audit
Executes an on-demand SEO scan against a specific URL to check for structural and meta tag issues.

## Prompt Examples

**Prompt:** 
```
Analyze the mobile page speed for 'https://example.com'.
```

**Response:** 
```
Analyzing mobile performance... Example.com has a mobile speed score of 82/100. The largest contentful paint (LCP) is 2.4s. I also detected 3 heavy image assets that could be optimized. Would you like the full list of errors?
```

**Prompt:** 
```
Show me the health status for property ID 'prop_123'.
```

**Response:** 
```
Accessing site health... Property prop_123 is currently Healthy (Score: 94/100). Uptime is 100% for the last 30 days. However, the SSL certificate expires in 12 days. Should I set a reminder for the renewal?
```

**Prompt:** 
```
Run an SEO audit for 'https://myblog.com/post-1'.
```

**Response:** 
```
SEO audit complete! I've scanned the post. Meta titles and descriptions are well-optimized. However, 2 images are missing alt tags and there is no H1 header defined. Would you like me to suggest some improvements?
```

## Capabilities

### Test Page Speed
Analyzes how quickly a specific URL loads when viewed on desktop or mobile devices.

### Check Site Health Status
Retrieves the overall health score and monitors critical elements like SSL certificate expiry for any connected property.

### Monitor Uptime History
Accesses historical data to show if a site experienced service interruptions over time, listing recent alerts as well.

### Audit SEO Elements
Performs on-demand scans of pages to check meta tags, headers, and detect broken links (404 errors).

### Scan for Code Errors
Scans a page specifically to identify JavaScript errors or overly heavy assets that hurt performance.

## Use Cases

### A client reports slow loading times after a site update.
The developer asks their agent to check the site performance. The agent runs `check_page_errors` and quickly identifies that three new JavaScript files are causing bloat, allowing the developer to fix them immediately.

### A marketing manager needs to audit 50 product pages for SEO compliance.
The specialist asks their agent to list all properties via `list_monitored_sites`. Then, they run `run_seo_audit` on a sample set, quickly spotting missing alt tags and incorrect meta titles across the entire catalog.

### A site owner is worried about an upcoming SSL certificate renewal deadline.
The agent runs `get_security_status` and immediately flags that the SSL certificate expires in 14 days. The owner can then set a reminder and get ahead of a critical outage.

### A maintenance team needs to check overall site reliability after an overnight deployment.
The engineer asks for `get_site_health` and reviews `list_recent_alerts`. The agent confirms the score is high, but points out a recent minor service interruption that needs investigation.

## Benefits

- Stop guessing about site performance. Running `check_speed_mobile` or `check_speed_desktop` gives you concrete scores and details on what's slowing the user down, whether it’s a heavy script or a large image asset.
- You get immediate visibility into your entire portfolio by using `list_monitored_sites`. This tool shows every website Hexometer tracks, so you never lose sight of an important property.
- Never worry about forgotten maintenance tasks again. Use `get_security_status` to confirm SSL certificate expiry and check the general security health across all your digital assets in one query.
- Eliminate wasted time on link checking. Instead of manually crawling, ask for `check_broken_links`, and the agent returns a clean list of every 404 error found.
- Maintain trust with clients by having real-time data access. Running `get_uptime_stats` provides irrefutable proof of service reliability over months or years.

## How It Works

The bottom line is that you talk to your AI client like talking to an engineer, and it handles all the background checking across multiple tools.

1. Subscribe to the Hexometer MCP and provide your API Key. You'll find this key in the property settings on the Hexometer site.
2. Connect this MCP to any compatible AI agent, like Cursor or Claude.
3. Ask your agent a specific question—for example, 'What is the mobile speed score for my main landing page?' The agent then uses the necessary tool to fetch and summarize the data.

## Frequently Asked Questions

**How does the Hexometer MCP check if my links are broken?**
The agent uses `check_broken_links` to scan a specified property and returns a list of all detected 404 errors. This saves you from having to crawl link by link.

**Can I get mobile speed data using the Hexometer MCP?**
Yes, run `check_speed_mobile` to analyze page load speed specifically for mobile users. This is vital because mobile performance often differs greatly from desktop results.

**What information does list_monitored_sites provide?**
`list_monitored_sites` gives you a complete inventory of every web property currently tracked in your Hexometer account, helping you ensure nothing is missed during an audit.

**Does the Hexometer MCP check for JavaScript errors?**
Yes. You can use `check_page_errors` to scan a page and specifically identify JavaScript errors or pinpoint assets that are overly heavy, helping you optimize code.

**How often should I run get_site_health with the Hexometer MCP?**
You should use `get_site_health` anytime major changes occur to a site, or weekly if you suspect performance degradation. It provides your overall health score and security status.