KosmoKrator

analytics

Prometheus MCP Integration for Claude Code

Connect Prometheus to Claude Code through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 7 read 0 write API token auth
Submit Prometheus feedback View package source

Connect Prometheus to Claude Code

Connect local KosmoKrator integrations to Claude Code through one scoped MCP gateway entry.

Add KosmoKrator as a stdio MCP server in the Claude Code project config and select the integrations that should be visible. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Code can inspect read-capable tools without receiving write access by default.

Prometheus MCP Config for Claude Code

Claude Code can launch the local kosmo binary directly from the project MCP config.

{
  "mcpServers": {
    "kosmokrator-prometheus": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=prometheus",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=prometheus --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Prometheus instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Prometheus Tools Visible to Claude Code

Claude Code sees stable MCP tool names generated from the Prometheus integration catalog.

MCP toolSource functionTypeDescription
integration__prometheus__prometheus_list_alerts prometheus.prometheus_list_alerts Read List Prometheus alerts. Optionally filter by alert state or label selectors. Returns alert names, states, labels, and annotations.
integration__prometheus__prometheus_get_alert prometheus.prometheus_get_alert Read Get a Prometheus alert by name. Returns the full alert definition including labels, annotations, and state.
integration__prometheus__prometheus_list_rules prometheus.prometheus_list_rules Read List Prometheus alerting and recording rules. Optionally filter by type. Returns rule groups with their rules and states.
integration__prometheus__prometheus_get_rule prometheus.prometheus_get_rule Read Get a Prometheus rule group by name. Returns the full rule group definition including all rules within the group.
integration__prometheus__prometheus_list_targets prometheus.prometheus_list_targets Read List Prometheus scrape targets. Optionally filter by state (active or dropped). Returns target health status, labels, and scrape info.
integration__prometheus__prometheus_get_target prometheus.prometheus_get_target Read Get a Prometheus target by its instance address. Returns target health, last scrape info, and discovery labels.
integration__prometheus__prometheus_get_current_user prometheus.prometheus_get_current_user Read Get the current authenticated Prometheus user info. Useful for verifying authentication and retrieving user details.

Related Prometheus Pages

Prometheus CLIUse direct JSON commands instead of MCP discovery. Prometheus MCPFull gateway reference and MCP tool names. KosmoKrator for Claude CodeClient-level gateway setup.