Overview
Consul MCP Server provides access to Consul functionality through a Model Context Protocol (MCP) interface. It connects to a configured Consul agent and exposes a unified MCP API for common operations across multiple domains, including service management, health checks, and the Key-Value store. Core capabilities include listing, registering, and deregistering services, retrieving service and catalog information, and querying health checks for services. It also supports KV operations (get, list, put, delete), session handling (list, destroy), event firing and listing, and prepared queries (create and execute). Additional capabilities cover cluster status (current leader and peers) and agent information (members and self). Configuration is via environment variables CONSUL_HOST and CONSUL_PORT (defaults: localhost and 8500). Start by running node build/index.js; the server connects to Consul and surfaces all functionality through the MCP interface. Claude config and Smithery installation options are provided for easy integration.
Features
Service Management
Expose MCP-enabled access to listing, registering/deregistering, and retrieving service information, plus catalog services and catalog service details.
Health Checks
Register and deregister health checks and retrieve health checks associated with services through the MCP interface.
Key-Value Store
Perform KV operations: get values, list keys, put values, and delete keys via MCP.
Sessions
List and destroy sessions used by services for coordination and locking in Consul.
Events
Fire events and list events to support event-driven workflows.
Prepared Queries
Create and execute reusable prepared queries against Consul data.
Status
Query current leader and peers to monitor cluster topology and health.
Agent
Inspect agent membership and self-information to understand agent topology.
Who Is This For?
- Developers:Access Consul features via MCP for integration into applications and services.
- DevOps:Automate management and operations of Consul through MCP in CI/CD and operational workflows.
- Claude users:Integrate Consul MCP capabilities into Claude workflows for automated tasks.
