McpMux
Back to Registry

Consul (Docker) MCP Server

Community

Contributed by HashiCorp

Connect to HashiCorp Consul via Docker for service discovery, health checks, key-value configuration, and service mesh operations. Query the catalog, inspect node and service health, read and write KV data, and manage ACLs in an isolated container.

About the Consul (Docker) MCP Server

The Consul (Docker) MCP server is a local (stdio) Model Context Protocol server available in the McpMux registry. Connect to HashiCorp Consul via Docker for service discovery, health checks, key-value configuration, and service mesh operations. Query the catalog, inspect node and service health, read and write KV data, and manage ACLs in an isolated container. This is a community-contributed MCP server by HashiCorp.

Install the Consul (Docker) MCP server with one click using McpMux. It works with Cursor, Claude Desktop, Claude Code, VS Code, ChatGPT, Windsurf, JetBrains, and any MCP-compatible AI client. This server requires authentication — McpMux securely stores your credentials with AES-256-GCM encryption.

Transport Configuration

Transport Configuration
{
  "type": "stdio",
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "CONSUL_HTTP_ADDR",
    "-e",
    "CONSUL_HTTP_TOKEN",
    "hashicorp/consul-mcp-server:latest"
  ],
  "env": {
    "CONSUL_HTTP_ADDR": "${input:CONSUL_HTTP_ADDR}",
    "CONSUL_HTTP_TOKEN": "${input:CONSUL_HTTP_TOKEN}"
  },
  "metadata": {
    "inputs": [
      {
        "id": "CONSUL_HTTP_ADDR",
        "label": "Consul HTTP Address",
        "description": "Base URL of your Consul HTTP API. Use host.docker.internal instead of localhost to reach a Consul agent running on the host machine (e.g., http://host.docker.internal:8500). Defaults to http://127.0.0.1:8500.",
        "type": "url",
        "required": true,
        "secret": false,
        "placeholder": "http://localhost:8500",
        "default": "http://localhost:8500"
      },
      {
        "id": "CONSUL_HTTP_TOKEN",
        "label": "Consul ACL Token",
        "description": "Consul ACL token used to authenticate with the HTTP API. Only required when ACLs are enabled on your Consul cluster; the token's policies determine which operations are permitted. Leave empty if ACLs are disabled.",
        "type": "text",
        "required": false,
        "secret": true,
        "placeholder": "********-****-****-****-************",
        "obtain": {
          "url": "https://developer.hashicorp.com/consul/commands/acl/token/create",
          "instructions": "1. Ensure ACLs are enabled on your Consul cluster\n2. Create a token scoped to the policies you need: consul acl token create -policy-name=<policy>\n3. Copy the SecretID value from the output",
          "button_label": "Create Token"
        }
      }
    ]
  }
}
Details
TransportLocal (stdio)
Hostinglocal
Authoptional_api_key
Capabilities
Tools

Categories

Tags

consulhashicorpservice-discoveryservice-meshkey-valuehealth-checksacldevopsdocker

Supported AI Clients

The Consul (Docker) MCP server works with all MCP-compatible AI clients through McpMux:

CursorClaude DesktopClaude CodeVS CodeChatGPTWindsurfJetBrainsZedClineGemini CLIAmazon Q

Related MCP Servers

Install Consul (Docker) with McpMux

One-click install from the McpMux desktop app. Auto-configures for Cursor, Claude, VS Code, ChatGPT, Windsurf, JetBrains, and any MCP-compatible client.