# Vongola

> Vongola is an open-source MCP server for cloud and infrastructure. Read-only operator view of Vongola, a Rust TLS reverse proxy built on Pingora. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Linux, self-hosted, CLI
- **Website:** https://qompass.ai/solutions/vongola/
- **Repository:** https://github.com/qompassai/vongola
- **MCP Registry name:** ai.qompass/vongola
- **Categories:** cloud and infrastructure, security
- **Listing updated:** 2026-11-14

## About

Vongola is Qompass AI's reverse proxy and web server, a clean-room rewrite on Pingora 0.9.0 that hosts qompass.ai and runs from a single small device up to a fleet sharing one versioned configuration bundle. This MCP server is its operator surface: the README describes it as read-only first, with mutations behind authentication, and the registry entry calls it read-only instrumentation. It is distributed as a Linux x64 `.mcpb` bundle.

Behind it sits a proxy with SNI certificate selection, TLS 1.3 only with ML-KEM hybrid key exchange (X25519MLKEM768 was negotiated in its smoke test), static hosting with cache rules and gzip, and health-checked round-robin upstreams. Other features include opt-in NAT traversal (PCP, NAT-PMP, UPnP IGD), Tor v3 onion services with a config check that forbids exit-relay mode, proxy chains that fail closed, a signed A2A Agent Card, Prometheus metrics and a live dashboard.

The code is Apache-2.0 and Rust; builds must link system OpenSSL 3.5 or newer. Three profiles (hosting, lean, fleet) set deployment style, and `POST /api/reload` swaps config and certificates atomically.

## Features

- **Read-only instrumentation:** Operator tooling that observes a running gateway without changing it.
- **Post-quantum TLS:** TLS 1.3 only with ML-KEM hybrid key exchange.
- **Fleet configuration:** Nodes share one versioned bundle across hosting, lean and fleet profiles.
- **Tor and NAT options:** Opt-in onion services and NAT traversal; never an exit relay.
- **Metrics and dashboard:** Prometheus metrics plus a live dashboard of upstreams, certificates and chains.

## Good for

- Check the state of a Vongola gateway from an assistant
- Inspect upstream health and certificates on a small node
- Review TLS and NAT settings before changing config
- Run a lean proxy on edge hardware

## Install

### Claude Code (Terminal)

```sh
claude mcp add vongola -- npx -y https://github.com/qompassai/vongola/releases/download/v0.2.0/vongola-mcp-0.2.0-linux-x64.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "vongola": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/vongola/releases/download/v0.2.0/vongola-mcp-0.2.0-linux-x64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "vongola": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/vongola/releases/download/v0.2.0/vongola-mcp-0.2.0-linux-x64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "vongola": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/vongola/releases/download/v0.2.0/vongola-mcp-0.2.0-linux-x64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "vongola": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/vongola/releases/download/v0.2.0/vongola-mcp-0.2.0-linux-x64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "vongola": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/vongola/releases/download/v0.2.0/vongola-mcp-0.2.0-linux-x64.mcpb"
      ]
    }
  }
}
```

## FAQ

### Can the MCP server change the gateway?

The registry describes it as read-only; the README says mutations, where they exist, sit behind authentication.

### What licence is Vongola?

Apache-2.0.

### What is it built on?

Rust and Pingora 0.9.0, with system OpenSSL 3.5 or newer for builds.

### Can it be a Tor exit node?

No. The configuration validator enforces that it never is.

### Is Vongola free?

Yes. Vongola is open source, so you can use and self-host it for free.

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

Run this command in your terminal: claude mcp add vongola -- npx -y https://github.com/qompassai/vongola/releases/download/v0.2.0/vongola-mcp-0.2.0-linux-x64.mcpb

### What are the best alternatives to Vongola?

The closest alternatives to Vongola are REA, Agent Roast, Midplane, Leash and Tinplate Edge AI Safety, Security & EU Compliance.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.

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