MCP.so
Sign In

Cribl MCP Server

@pebbletek

About Cribl MCP Server

Cribl MCP Server

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "cribl-mcp": {
      "command": "npx",
      "args": [
        "@pebbletek/cribl-mcp"
      ],
      "env": {
        "CRIBL_BASE_URL": "https://your.cribl.cloud.instance",
        "CRIBL_AUTH_TYPE": "cloud",
        "CRIBL_CLIENT_ID": "abc123",
        "CRIBL_CLIENT_SECRET": "secret"
      }
    }
  }
}

Tools

10

Lists available worker groups in the Cribl deployment, optionally filtered by product type (stream, edge, search, or all).

Fetches pipeline definitions in a specified worker group.

Fetches source configurations in a specified worker group.

Retrieves full configuration JSON for a specified pipeline in a worker group.

Applies a new configuration payload to a specified pipeline in a worker group.

Restarts all workers within the default or specified worker group.

Retrieves system metrics from the Cribl deployment. IMPORTANT: To avoid excessively large responses, please use the optional parameters (filterExpr, metricNameFilter, earliest, latest, numBuckets, wp) to narrow down your query whenever possible. If no parameters are provided, the server will default to fetching only the most recent data bucket (numBuckets=1) to prevent performance issues.

Detects if version control (git) is enabled on the Cribl instance and whether a remote repository URL is configured.

Commits staged pipeline config changes to version control with a message. Returns detailed commit information including branch, commit ID, and summary of changed files.

Deploys a specific committed configuration version to a worker group. Returns the list of ConfigGroup objects Cribl provides.

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.

Frequently asked questions

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.

Comments

More Other MCP servers