Consul MCP Server

Consul MCP Server for Discovery and Mesh

Local serverstdio

What is the Consul MCP Server?

Consul MCP Server for Discovery and Mesh

The short version

A Model Control Protocol (MCP) server for interacting with HashiCorp Consul service discovery and service mesh. This implementation follows Anthropic's MCP specification and allows Claude to analyze your microservices architecture, create diagrams, identify issues, and provide recommendations through natural language interaction.

Model Control Protocol (MCP) is a specification developed by Anthropic that enables AI models like Claude to interact with external tools and APIs. This implementation connects AI Agents to your Consul infrastructure, allowing you to manage and analyze your services using natural language.

  • List and analyze services registered in Consul
  • Identify and diagnose failing health checks
  • Generate service mesh architecture diagrams
  • Detect service connection issues and provide recommendations
  • Get AI insights on service load balancing and resource utilization

What it needs from you

  • Node.js 18+ - npm or yarn - A running Consul instance (local or remote) - Claude Desktop or Cursor IDE with Claude integration

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Consul MCP Server

{
  "mcpServers": {
    "consul-mcp-server-3loka": {
      "command": "npx",
      "args": ["-y", "consul-mcp-server"],
      "env": {
        "CONSUL_HTTP_ADDR": "your-value",
        "CONSUL_HTTP_TOKEN": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Node.js 18+ - npm or yarn - A running Consul instance (local or remote) - Claude Desktop or Cursor IDE with Claude integration
VariableDescriptionRequired
CONSUL_HTTP_ADDRConfiguration value read at startup.Optional
CONSUL_HTTP_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • “Use Consul to CONSUL HTTP ADDR.”
  • “Use Consul to CONSUL HTTP TOKEN.”
  • “Use Consul to PORT.”

Frequently asked questions

MCP is an Anthropic specification that enables AI models like Claude to interact with external tools and APIs. This server connects AI agents to your Consul infrastructure.