Overview
What is Cribl MCP Server?
A Model Context Protocol (MCP) server that enables AI interactions with the Cribl API. It allows AI clients to discover and invoke data operations from a Cribl deployment using standardised MCP tooling.
How to use Cribl MCP Server?
Run instantly via npx by setting the required environment variables (CRIBL_BASE_URL, CRIBL_AUTH_TYPE, CRIBL_CLIENT_ID, CRIBL_CLIENT_SECRET). For local development, clone the repo, install dependencies, and configure a .env file. Then connect an MCP client (e.g., Claude Desktop) to the server to issue natural language prompts.
Key features of Cribl MCP Server
- List Worker Groups and Fleets
- Get and set Pipeline configurations
- Get Source configurations
- Restart Worker Groups
- Query System Metrics with filtering
Use cases of Cribl MCP Server
- Discover configured data sources and pipelines via natural language
- Inspect pipeline processing functions and their details
- Modify pipeline configurations and apply changes
- Restart worker groups to deploy updated configurations
- Query system metrics for monitoring and troubleshooting
FAQ from Cribl MCP Server
What are the prerequisites to run the server?
Node.js version 16 or later and internet access (to fetch the package from npm).
How do I authenticate with Cribl?
Set CRIBL_AUTH_TYPE (e.g., cloud) and provide matching credentials (CRIBL_CLIENT_ID, CRIBL_CLIENT_SECRET) and CRIBL_BASE_URL. See the configuration documentation for other auth modes.
Can I run the server without installing anything locally?
Yes, use npx with the required environment variables: CRIBL_BASE_URL=... CRIBL_AUTH_TYPE=cloud CRIBL_CLIENT_ID=... CRIBL_CLIENT_SECRET=... npx @pebbletek/cribl-mcp
What operations can I perform with the Cribl MCP Server?
List Worker Groups/Fleets, get/set Pipeline configurations, get Source configurations, restart Worker Groups, and query System Metrics (with filtering).
What is the license for the Cribl MCP Server?
The server is released under the MIT license.
