Manage Consul Services via Standardized Interface

Consul MCP Server exposes HashiCorp Consul's functionality to AI assistants through a standardized Model Context Protocol interface, covering service management, health checks, the key-value store, sessions, events, prepared queries, cluster status, and agent information.

Use this when an AI assistant needs to inspect or operate a Consul-backed service mesh or configuration store - checking which services are registered and healthy, reading or writing KV data, firing events, or running prepared queries - directly from a conversation instead of the Consul CLI or UI. It connects to an existing Consul agent via host/port configuration, so it requires a running Consul deployment to be useful; it does not stand up Consul itself.

• Service management: list running services, register/deregister services, get service info, list and query catalog services
• Health checks: register/deregister health checks, get health checks for services
• Key-value store: get values, list keys, put values, delete keys
• Sessions: list sessions, destroy sessions
• Events: fire events, list events
• Prepared queries: create and execute prepared queries
• Status: get current leader, get current peers
• Agent: get agent members, get agent self information
• System: get system health service information

Configure via environment variables:

• CONSUL_HOST (default localhost)
• CONSUL_PORT (default 8500)

Build and run:

npm install
npm run build
node build/index.js

Claude Desktop configuration:

{
    "mcpServers": {
        "consul-mcp": {
            "command": "node",
            "args": ["/ABSOLUTE/PATH/TO/PARENT/FOLDER/consul-mcp-server/build/index.js"]
        }
    }
}

Or install via Smithery:

npx -y @smithery/cli install @kocierik/consul-mcp-server --client claude

For debugging, use the MCP Inspector: npm run build && npx @modelcontextprotocol/inspector node build/index.js.

Platform engineers and SREs running HashiCorp Consul for service discovery, health checking, or distributed KV configuration who want an AI assistant to query and operate that infrastructure directly. Licensed MIT.