# TunnelHQ

> TunnelHQ is an MCP server for cloud and infrastructure. Check VPN tunnels and uptime from chat, with read-only or read-and-write sign-in. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Starting price:** $12 a month
- **Platforms:** Web, API, CLI
- **Website:** https://tunnelhq.com/ai/
- **MCP Registry name:** com.tunnelhq/tunnelhq
- **Categories:** cloud and infrastructure
- **Listing updated:** 2026-11-14

## About

A VPN operator can ask which tunnels are down and why, and get answers such as a named server unreachable since a given time, then retest it. The hosted server covers tunnels, uptime checks, heartbeats, status pages, maintenance windows, incidents and subscriptions across 51 tools.

Permissions are chosen when you approve a client: a workspace, all projects or one, and read only or read and write. Read and write can add, edit, test and acknowledge but never delete, and it cannot reach API keys, billing or team members. Revoking ends a connection at once, and unused connections lapse after 90 days. Running the server with an API key is the route for deletes.

One feature worth knowing: an assistant can test a config, share link or subscription URL, or a batch of them, before you ship.

## Features

- **Down-now answers:** Lists failing monitors with the reason.
- **Test VPN servers:** Tests a config, link or subscription, singly or in batches.
- **Incident handling:** List incidents, acknowledge and retest.
- **Status pages:** Create, update and publish status pages and incidents.
- **Scoped approval:** Choose workspace, project and read-only or read-write.
- **No deletes:** The OAuth connection cannot delete or touch billing and keys.

## Good for

- Ask which tunnels are failing right now
- Test a batch of new VPN configs
- Acknowledge an incident and retest its monitor
- Have an assistant propose uptime checks for a project
- Post a status page update

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http tunnelhq https://mcp.tunnelhq.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.tunnelhq.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tunnelhq": {
      "url": "https://mcp.tunnelhq.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tunnelhq": {
      "type": "http",
      "url": "https://mcp.tunnelhq.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tunnelhq": {
      "serverUrl": "https://mcp.tunnelhq.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tunnelhq": {
      "type": "http",
      "url": "https://mcp.tunnelhq.com/mcp"
    }
  }
}
```

## Tools

- `List monitors`: Lists monitors and their status.
- `Get a monitor's check history`: Shows recent check results for a monitor.
- `List recent failures`: Lists recent failed checks.
- `List incidents`: Lists incidents with timelines.
- `Acknowledge an incident`: Acknowledges an incident.
- `Retest an incident's monitor`: Reruns the test for an incident's monitor.
- `Test a VPN server`: Tests a VPN config or link.
- `Add a VPN monitor`: Creates a monitor for a tunnel.

## FAQ

### Which assistants can connect?

Claude, Claude Code, ChatGPT, Cursor, VS Code and Windsurf, or any client supporting streamable HTTP with OAuth.

### Can it delete things?

Not over OAuth; deleting needs a server run with an API key.

### Which plans include it?

Starter, Pro and Business.

### Does TunnelHQ see my conversation?

No; it receives only the actions requested and stores tokens as SHA-256 hashes.

### Is TunnelHQ free?

TunnelHQ is a paid product with a free trial. Paid plans start at $12 a month.

### How do I add TunnelHQ to Claude Code?

Run this command in your terminal: claude mcp add --transport http tunnelhq https://mcp.tunnelhq.com/mcp

### What are the best alternatives to TunnelHQ?

The closest alternatives to TunnelHQ are Agent Yurt, Proofline, filex, MagicWP MCP and Kubana Cloud Domains.

## Alternatives

- [Agent Yurt](https://ai-powered.com/mcp/agent-yurt): Agent Yurt is a free MCP server for knowledge and memory.
- [Proofline](https://ai-powered.com/mcp/proofline): Proofline is a freemium MCP server for developer tools.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [MagicWP MCP](https://ai-powered.com/mcp/magicwp-mcp): MagicWP MCP is an MCP server for cloud and infrastructure.
- [Kubana Cloud Domains](https://ai-powered.com/mcp/kubana-cloud-domains): Kubana Cloud Domains is a paid MCP server for cloud and infrastructure.
- [Kubana Cloud DNS Management](https://ai-powered.com/mcp/kubana-cloud-dns-management): Kubana Cloud DNS Management is a free MCP server for cloud and infrastructure.
- [Kubana Cloud VPS](https://ai-powered.com/mcp/kubana-cloud-vps): Kubana Cloud VPS is a paid MCP server for cloud and infrastructure.
- [AgentViva](https://ai-powered.com/mcp/agentviva): AgentViva is a free MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/tunnelhq
