monitoringgrafanaprometheusdatadogkafka
Local MCP server to query Grafana, Prometheus, Kafka UI, and Datadog with BYOK credentials in env vars.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
We couldn’t automatically confirm this listing starts correctly
The install command below didn't complete successfully in our automated test.
npx -y processnpm ERR! could not determine executable to run npm ERR! A complete log of this run can be found in: /home/user/.npm/_logs/2026-08-09T15_26_25_884Z-debug-0.log
This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Overview
Use cases
Query Grafana dashboards and alerts programmatically
Run Prometheus queries and retrieve metrics
Access Kafka UI information through AI agents
Fetch Datadog monitoring data securely
Perform unified health checks across observability backends
Key features
Supports Grafana, Prometheus, Kafka UI, and Datadog
BYOK model with credentials in environment variables
Partial setup exposing only configured backends
Unified health check tool across all configured services
Interactive CLI wizard for quick configuration
Compatible with Claude Code and OpenAI Codex clients
Capabilities & Tool Schemas
Inspect callable tools, capabilities, and parameters exposed to AI agents by Byok Observability MCP.
Extracted Tool Capabilities
Supports Grafana, Prometheus, Kafka UI, and Datadog
BYOK model with credentials in environment variables
Partial setup exposing only configured backends
Unified health check tool across all configured services
Interactive CLI wizard for quick configuration
Compatible with Claude Code and OpenAI Codex clients
Documentation Overview
byok-observability-mcp
Query your observability stack from Claude Code, Codex, or any MCP client and no data leaves your machine.
Bring Your Own Keys — credentials stay in env vars on your machine. No clone, no build, runs via npx.
Partial setup — configure only the backends you use. Tools for unconfigured backends are never exposed.
Quick Start · Tools · Credentials · Configuration · Scheduled Reports · Examples · Security · Development
How it works
🤖 Claude Code / Codex CLI
│
▼
⚡ byok-observability-mcp
(Local npx process)
│
🔒 env vars never leave your machine
│
▼
┌─────────────────────────────────┐
│ 📊 Grafana 🔥 Prometheus │
│ 🛶 Kafka UI 🐶 Datadog │
└─────────────────────────────────┘
⚡ Quick Start
Option A — Interactive wizard (recommended)
Run once, answer a few questions, get a ready-made .mcp.json:
The wizard will:
- Let you pick which backends to configure
- Ask for credentials per service
- Test connectivity with your real endpoints before writing anything
- Write
.mcp.jsonto your project root or~/.claude/— your choice
Then just start Claude Code:
[!TIP] That's it. No clone, no build, no env file. Works in under 60 seconds.
Option B — Manual .mcp.json
Create .mcp.json in your project root. Include only the backends you need.
Credentials in git? Use the
${VAR}approach instead — see Configuration → Method B.
Start Claude Code:
Claude Code reads .mcp.json automatically. No claude mcp add, no build step.
Verify by asking Claude:
🧩 Supported clients
| Client | Configuration |
|---|---|
| Claude Code | .mcp.json in project root (recommended) or claude mcp add CLI |
| OpenAI Codex CLI | .mcp.json in project root — same format as Claude Code |
Both clients read .mcp.json automatically. The Quick Start above works for either.
Codex CLI example
Or add via CLI:
🔧 Available tools
🛰️ System — 1 tool
Always available. Checks connectivity across all configured backends.
| Tool | Description |
|---|---|
obs_health_check | Unified Health Check. Runs a parallel check on all backends and returns a status table. |
7 tools
Enabled when
GRAFANA_URL+GRAFANA_TOKENare set.
| Tool | Description |
|---|---|
grafana_health | Check connectivity, version, and database status |
grafana_list_datasources | List all datasources (name, type, UID) |
grafana_query_metrics | Run a PromQL expression via a Grafana datasource |
grafana_list_dashboards | Search and list dashboards by name or tag |
grafana_get_dashboard | Get panels and metadata for a dashboard by UID |
grafana_list_alerts | List active alerts from Alertmanager (firing/pending) |
grafana_get_alert_rules | List all configured alert rules across all folders |
5 tools
Enabled when
PROMETHEUS_URLis set.
| Tool | Description |
|---|---|
prometheus_health | Check connectivity |
prometheus_query | Instant PromQL query — current value of a metric |
prometheus_query_range | Range PromQL query — metric values over time |
prometheus_list_metrics | List all available metric names |
prometheus_metric_metadata | Get help text and type for a specific metric |
6 tools
Enabled when
KAFKA_UI_URLis set.
| Tool | Description |
|---|---|
kafka_list_clusters | List configured Kafka clusters and their status |
kafka_list_topics | List topics in a cluster |
kafka_describe_topic | Get partition count, replication factor, and config |
kafka_list_consumer_groups | List consumer groups and their state |
kafka_consumer_group_lag | Get per-partition lag for a consumer group |
kafka_broker_health | Broker count and disk usage per broker |
proxied via official server
Enabled when both
DD_API_KEYandDD_APP_KEYare set. Proxies the official Datadog MCP server.
Default toolsets: core, apm, alerting. Set DD_TOOLSETS=all to load everything.
| Toolset | Covers |
|---|---|
core | Metrics, dashboards, monitors, infrastructure |
apm | APM services, traces, service map |
alerting | Monitors, downtimes, alerts |
logs | Log search and analytics |
incidents | Incident management |
ddsql | SQL-style metric queries |
security | Cloud security posture |
synthetics | Synthetic test results |
networks | Network performance monitoring |
dbm | Database monitoring |
software-delivery | CI/CD pipelines |
llm-obs | LLM observability |
cases | Case management |
feature-flags | Feature flag tracking |
🔑 Getting credentials
Service account token
- Open Grafana → Administration → Users and access → Service accounts
- Click Add service account → set Role to
Viewer→ Create - On the service account page → Add service account token → Generate token
- Copy the token (starts with
glsa_) — you won't see it again
If your Grafana uses a self-signed certificate:
URL (+ optional basic auth)
If Prometheus has no authentication:
If Prometheus uses basic auth:
URL (+ optional login)
If Kafka UI has no authentication:
If Kafka UI requires a login:
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
GitHub stars
4
Stargazers on the source repository.
npm downloads
202M
Package downloads in the last 30 days.
Last commit
5mo ago
Most recent push to the default branch.
Install check
Inconclusive
Install command did not finish in our automated test.
Directory activity
2 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Byok Observability MCP
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/alimuratkuslu-byok-observability-mcp)HTML Embed
<a href="https://allmcps.com/mcp/alimuratkuslu-byok-observability-mcp"><img src="https://allmcps.com/api/badge/alimuratkuslu-byok-observability-mcp?style=directory" alt="Byok Observability MCP on AllMCPs" /></a>Technical Specs & Signals
CategoryMonitoring
PricingFree
10/10 checks healthy over the last 32d
52Quality signal: Good · 52/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools23/30
Adoption & activity6/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Supply-chain signal
No high-severity advisories surfaced by our automated scan.
Critical 0High 0Medium 0Low 0
Scanned 23d ago via OSV.dev · process (npm)
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.