Druid

You can manage and analyze Apache Druid clusters using this MCP server, which provides a structured, tool-driven interface for data management, ingestion, monitoring, and security. It exposes a flexible set of MCP components that you can access from supported MCP clients to perform powerful operations in a consistent, scalable way.

How to use

Connect to the MCP server using an MCP client over either the Streamable HTTP transport or the local STDIO transport. Streamable HTTP exposes a single /mcp endpoint for concurrent clients, with optional Server-Sent Events streaming for real-time updates. STDIO runs locally, suitable for integration with LLM clients and desktop tools. Once connected, you can explore and run tools, read data via resources, and follow AI-assisted prompts to guide Druid management tasks.

Available tools

listDatasources

List all available Druid datasource names

showDatasourceDetails

Show detailed information for a specific datasource including column information

killDatasource

Permanently remove a datasource and its data and metadata

listLookups

List all available Druid lookups from the coordinator

getLookupConfig

Get configuration for a specific lookup

updateLookupConfig

Update configuration for a specific lookup

listAllSegments

List all segments across all datasources

getSegmentMetadata

Get metadata for specific segments

getSegmentsForDatasource

Get all segments for a specific datasource

queryDruidSql

Execute a SQL query against Druid datasources

viewRetentionRules

View retention rules for all datasources or a specific one

updateRetentionRules

Update retention rules for a datasource

viewAllCompactionConfigs

View compaction configurations for all datasources

viewCompactionConfigForDatasource

View compaction configuration for a specific datasource

editCompactionConfigForDatasource

Edit compaction configuration for a datasource

deleteCompactionConfigForDatasource

Delete compaction configuration for a datasource

viewCompactionStatus

View compaction status for all datasources

viewCompactionStatusForDatasource

View compaction status for a specific datasource

createBatchIngestionTemplate

Create a batch ingestion template

createIngestionSpec

Create and submit an ingestion specification

listSupervisors

List all streaming ingestion supervisors

getSupervisorStatus

Get status of a specific supervisor

suspendSupervisor

Suspend a streaming supervisor

startSupervisor

Start or resume a streaming supervisor

terminateSupervisor

Terminate a streaming supervisor

listTasks

List all ingestion tasks

getTaskStatus

Get status of a specific task

shutdownTask

Shutdown a running task

checkClusterHealth

Check overall cluster health status

getServiceStatus

Get status of specific Druid services

getClusterConfiguration

Get cluster configuration information

runDruidDoctor

Run comprehensive cluster diagnostics

analyzePerformanceIssues

Analyze cluster performance issues

generateHealthReport

Generate detailed health report

testQueryFunctionality

Test query functionality across services

testIngestionFunctionality

Test ingestion functionality

validateClusterConnectivity

Validate connectivity between cluster components

listAuthenticationUsers

List all users in the Druid authentication system for a specific authenticator

getAuthenticationUser

Get details of a specific user from the Druid authentication system

createAuthenticationUser

Create a new user in the Druid authentication system

deleteAuthenticationUser

Delete a user from the Druid authentication system

setUserPassword

Set or update the password for a user in the Druid authentication system

listAuthorizationUsers

List all users in the Druid authorization system for a specific authorizer

getAuthorizationUser

Get details of a specific user from the Druid authorization system including their roles

listRoles

List all roles in the Druid authorization system for a specific authorizer

getRole

Get details of a specific role from the Druid authorization system including its permissions

createAuthorizationUser

Create a new user in the Druid authorization system

deleteAuthorizationUser

Delete a user from the Druid authorization system

createRole

Create a new role in the Druid authorization system

deleteRole

Delete a role from the Druid authorization system

setRolePermissions

Set permissions for a role in the Druid authorization system

assignRoleToUser

Assign a role to a user in the Druid authorization system

unassignRoleFromUser

Unassign a role from a user in the Druid authorization system

getAuthenticatorChainAndAuthorizers

Get configured authenticatorChain and authorizers from Basic Auth configuration