LABSCO SUMMARY
The whole Consul surface, including the parts that change state.
Reading the catalogue and KV is the everyday case, but registration, deregistration and key deletion are here too — this is an operator's tool, not a dashboard. There is no auth setting in the configuration, so the reachable Consul endpoint is the security boundary; point it at a cluster you are comfortable letting an agent modify.
What it is
An MCP server that exposes Consul's HTTP functionality — service catalogue, health checking, key-value store, sessions, events, prepared queries and agent status — so an agent can inspect and change a Consul cluster in conversation.
What you get
- Services — list running services, register and deregister, read service information, browse the catalog
- Health — register and deregister health checks, and read the checks for a service
- Key-value store — get a value, list keys, put a value, delete a key
- Sessions and events — list and destroy sessions; fire and list events
- Prepared queries — create and execute
- Cluster status — current leader, current peers, agent members, agent self information, and system health service information
Requirements
Node.js and a reachable Consul agent. Clone the repo, npm install, npm run build, then register node build/index.js with your client. Point it at your cluster with CONSUL_HOST (default localhost) and CONSUL_PORT (default 8500). No account or key of its own; whatever the Consul endpoint permits is what it can do. Package version 1.0.0. MIT.
Setup effort
Build from source
USE CASES
01
Working out why a service is unhealthy
List the registered services, then read the health checks attached to the one that is failing.
02
Reading or changing a config value
List the keys under a prefix, read the current value, and write the new one.
03
Checking the cluster is where you think it is
Ask for the current leader, the peers and the agent members before making any change.
04
Registering a service you just brought up
Register the service with its health check, then confirm it appears in the catalog.
INSTALLATION
Connect your client
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"consul-mcp": {
"command": "node",
"args": [
"<YOUR_PATH_TO_PARENT_FOLDER>/consul-mcp-server/build/index.js"
]
}
}
}