How to Use the Hexometer MCP in Claude Code

Q: Can I pipe Hexometer data from Claude Code into other command-line tools?

Yes, that's what it's for. For example, run claude mcp exec hexometer listrecentalerts jq '.' to format the JSON, or pipe it to a custom script for processing.

Q: What's the best way to script uptime checks with Hexometer and Claude Code?

Create a simple shell script with claude mcp exec hexometer getuptimestats --site yoursite.com. Run that script via a cron job every five minutes and append the output to a log file or a database.

Q: What about the security of my Hexometer data in a CI/CD environment with Claude Code?

Your Hexometer site health data, like uptime stats from getuptimestats, is fetched by your script and never stored by Vinkius. The connection is ephemeral and sandboxed, meaning your API credentials and site data are not persisted on the server.

Automate your SRE and DevOps workflows with Hexometer data directly in your terminal using Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Hexometer MCP to Claude Code

Create your Vinkius account to connect Hexometer to Claude Code 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 Hexometer with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Site Monitoring for Your CI/CD Pipeline

This isn't for GUIs. This MCP server puts Hexometer's monitoring tools into your shell scripts and automated workflows. Run `get_site_health` as a build step to fail any deployment that hurts performance. Use `get_security_status` to check for SSL issues before a release goes live. The output is clean and easy to parse, perfect for scripting. It's designed for headless execution.

Pipe Live Alerts to Any Service

Get alerts where you need them. The `list_recent_alerts` tool gives you a stream of monitoring events. You can pipe this directly to a script that files a ticket, sends a Slack message, or triggers a PagerDuty incident. Same goes for uptime. Set up a cron job to call `get_uptime_stats` every five minutes and log it to a time-series database. You control the data flow completely.

Run Audits from the Command Line with Claude Code

Forget logging into a dashboard. From your terminal, you can kick off a full `run_seo_audit` on a new URL or use `check_broken_links` to generate a list of 404s before a content migration. This is about speed and efficiency. Check mobile and desktop performance with `check_speed_mobile` and `check_speed_desktop`, then `grep` the output for the exact metric you care about. It's raw, powerful access.

Setup guide

Set up Hexometer MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see hexometer-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Hexometer transactions." It will automatically discover and invoke the available Hexometer tools.

Terminal

claude mcp add --transport http hexometer-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Hexometer MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "hexometer-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Hexometer. 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 Hexometer 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 Hexometer MCP in Claude Code

In your workflow YAML file, add a step to install Claude Code and add the Hexometer server. Then you can run commands like `claude mcp exec hexometer get_site_health` and fail the build if the health score is too low.

Yes, that's what it's for. For example, run `claude mcp exec hexometer list_recent_alerts | jq '.'` to format the JSON, or pipe it to a custom script for processing.

Create a simple shell script with `claude mcp exec hexometer get_uptime_stats --site yoursite.com`. Run that script via a cron job every five minutes and append the output to a log file or a database.

Yes, your usage is subject to Hexometer's API rate limits. This MCP server doesn't add its own limits, but if you script heavy usage of tools like `check_page_errors`, you might hit the Hexometer account limits.

Your Hexometer site health data, like uptime stats from `get_uptime_stats`, is fetched by your script and never stored by Vinkius. The connection is ephemeral and sandboxed, meaning your API credentials and site data are not persisted on the server.

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