Skip to main content
Glama
Consul MCP Server

Consul MCP Server

by youngitn

Consul MCP Server (Customized)

This is a customized version of the Consul MCP Server modified specifically to support Consul ACL Tokens.

What's Changed?

  • Added support for CONSUL_TOKEN environment variable.

  • The underlying Consul client now correctly authenticates to secure clusters (with ACL enabled), allowing it to fetch both Services and Key-Value (KV) configurations without being blocked as an anonymous user.

Related MCP server: Consul MCP Server

Configuration in MCP / Claude / Cursor

Use the following configuration in your mcp_config.json (or equivalent IDE settings):

{
  "mcpServers": {
    "consul-mcp": {
      "command": "node",
      "args": [
        "C:/path/to/your/consul-mcp-server/build/index.js"
      ],
      "env": {
        "CONSUL_HOST": "10.4.0.53",
        "CONSUL_PORT": "8500",
        "CONSUL_TOKEN": "your-acl-token-here"
      }
    }
  }
}

Setup & Build

  1. Clone this repository

  2. Run npm install

  3. Run npm run build

Available Tools

24 tools
create-prepared-queryC

Create a new prepared query

Inputs: name, service, nearestN, datacenters.

delete-kvB

Delete a key from the KV store

Inputs: key.

deregister-health-checkC

Deregister a health check from Consul

Inputs: id.

deregister-serviceB

Deregister a service from Consul

Inputs: id.

destroy-sessionC

Destroy a session in Consul

Inputs: id.

execute-prepared-queryC

Execute a prepared query

Inputs: id.

fire-eventC

Fire a new event

Inputs: name, payload.

get-agent-membersC

Get agent members

Inputs: no named parameters.

get-agent-selfB

Get agent self information

Inputs: no named parameters.

get-catalog-nodesB

Get nodes from the catalog

Inputs: no named parameters.

get-catalog-serviceB

Get information about a specific service from the catalog

Inputs: service.

get-health-checksC

Get health checks for a service

Inputs: service.

get-kvB

Get a value from the KV store

Inputs: key.

get-leaderC

Get the current leader

Inputs: no named parameters.

get-peersB

Get the current peers

Inputs: no named parameters.

get-servicesB

Get running services

Inputs: no named parameters.

list-catalog-servicesA

List all services in the catalog

Inputs: no named parameters.

list-eventsC

List all events

Inputs: name.

list-kvC

List keys in the KV store

Inputs: prefix.

list-sessionsA

List all sessions in Consul

Inputs: no named parameters.

put-kvC

Put a value in the KV store

Inputs: key, value.

register-health-checkB

Register a health check with Consul

Inputs: id, ttl, http, name, +4 more.

register-serviceC

Register a service with Consul

Inputs: id, name, port, tags, +1 more.

reload-agentB

Reload agent configuration

Inputs: no named parameters.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 24 tools

    Disambiguation5/5

    Every tool targets a distinct resource and action (e.g., get-kv vs put-kv vs delete-kv, register-service vs deregister-service). Potential overlaps like get-services vs list-catalog-services are resolved by context (agent-local vs catalog-wide). No ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb-noun pattern with hyphens (e.g., get-kv, list-sessions, register-service). Verbs are uniformly imperative and resources are clearly named. No mixing of styles.

    Tool Count4/5

    24 tools is slightly above the typical well-scoped range, but it covers the core Consul operations (KV, services, health checks, sessions, events, catalog, agent). The count is justified by the breadth of Consul's API.

    Completeness4/5

    The tool set covers most essential Consul operations: CRUD for KV, service and health check registration/deregistration, prepared queries, events, and agent info. Missing session creation (only destroy and list) is a minor gap, but overall the surface is comprehensive.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol server that allows language models to manage Hetzner Cloud resources through structured functions, including servers, volumes, firewalls, and SSH keys.
      30
      153
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      A Model Context Protocol server that provides seamless integration with Coroot observability platform, enabling monitoring of applications, analysis of performance metrics, examination of logs and traces, and management of infrastructure through Coroot's comprehensive API.
      61
      47 PyPI
      16
      MIT