Skip to main content
Glama

Ghost Networks MCP Server

Private, Programmable Networking for the AI Age.

Manage your Ghost Networks private mesh (WireGuard-grade encryption) from any MCP client — Claude, Cursor, Codex, Gemini, Windsurf and others. Create networks, add and revoke devices, organize Phantom Hubs, issue Helbind Keys and BiFrost Passes, run Ghost VPN servers and route traffic through exit nodes, all in natural language.

The MCP server is built into the Ghost CLI (ghost-cli mcp): a single signed binary, no runtime or extra packages.

Requirements

A Ghost Networks Enterprise plan (CLI, or CLI, API & VPN Server) and its API key. Plans start with a first month for $9.90 — see gh-o.net/pricing.

Related MCP server: pfSense MCP Server

Install

1. Install the Ghost CLI (it contains the MCP server). Skip this step if you use the .mcpb bundle.

macOS / Linux:

curl -fsSL https://gh-o.net/d/cli/install.sh | bash
# or
brew install habloapp/ghost/ghost-cli

Windows (PowerShell as Administrator):

irm https://gh-o.net/d/cli/install.ps1 | iex

2. Add it to your client:

Install in Cursor Install in VS Code

Client

How

Claude Desktop

Download the .mcpb bundle for your platform from the latest release, open it and paste your API key. No CLI needed.

Claude Code (plugin)

/plugin install ghost --marketplace ghost-networks/ghost-mcp (with GHOST_API_KEY set in your shell, or after ghost-cli init <your-api-key>)

Claude Code (CLI)

claude mcp add ghost -e GHOST_API_KEY=<your-api-key> -- ghost-cli mcp

Codex

codex mcp add ghost --env GHOST_API_KEY=<your-api-key> -- ghost-cli mcp

Gemini CLI

gemini extensions install https://github.com/ghost-networks/ghost-mcp (asks for your API key)

Cursor

Button above, then replace <your-api-key>

VS Code

Button above (asks for your API key)

Windsurf and others

Add the JSON below to the client's MCP configuration

{
  "mcpServers": {
    "ghost": {
      "command": "ghost-cli",
      "args": ["mcp"],
      "env": { "GHOST_API_KEY": "<your-api-key>" }
    }
  }
}

On the first tool call the CLI registers itself with your API key and stores its credentials locally (~/.ghost-cli/config.json). You can also run ghost-cli init <your-api-key> once instead of setting GHOST_API_KEY.

Tools

41 tools covering networks, devices, Phantom Hubs, Helbind Keys, BiFrost Passes, Ghost VPN, roles and exit nodes. Full list with parameters: TOOLS.md (generated with ghost-cli mcp --list-tools).

Listing tools (tools/list) works without an API key, so you can inspect the server before subscribing.

Security

  • All operations go through the same end-to-end encrypted API channel as the Ghost CLI.

  • Your API key and device keys stay on your machine.

Support

gh-o.net/support


Ghost Networks™ is a trademark of HabloApp Inc. BiFrost Pass*, Phantom Hubs* and Helbind Keys* are patent-pending technologies.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables Claude Desktop, Claude Code, and other MCP clients to manage firewall rules, VPNs, NAT, DNS, DHCP, routing, certificates, and diagnostics through natural language, with guardrails, rate limits, and config-revision backups that make destructive changes reversible.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables natural-language management of pfSense firewalls through MCP clients, covering firewall rules, VPNs, DNS, DHCP, diagnostics, configuration backup, and safety guardrails for destructive changes. It supports wire-format-verified operations across major pfSense subsystems with confirmation, rate limits, and rollback guidance.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables users to control firewall rules, VPNs, DNS, DHCP, and diagnostics in natural language from MCP clients, with safety guardrails, config backups, and rollback support.
      -