KosmoKrator

analytics

Prometheus MCP Integration for Codex

Connect Prometheus to Codex 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 Codex

Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy.

Register kosmo mcp:serve as a local stdio server and choose the integration allowlist. The gateway is local, scoped to this integration, and starts with --write=deny so Codex can inspect read-capable tools without receiving write access by default.

Prometheus MCP Config for Codex

Keep write access denied or ask-based unless the workspace is trusted.

{
  "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 Codex

Codex 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 CodexClient-level gateway setup.