Skip to content

Ask it from an agent

github-actions[bot] edited this page Nov 18, 2026 · 1 revision

lapilli serve speaks MCP at /mcp (Streamable HTTP), so an agent can ask it what the pages show, and check a change to the rules before anyone makes it. The agent can be Claude Code, Cursor, VS Code, or one of your own:

kubectl -n monitoring port-forward svc/lapilli 8080
claude mcp add --transport http lapilli http://localhost:8080/mcp

compare is off until --mcp-compare editors (or admins) turns it on, with roles set.

Six tools read what the pages show, each answer as JSON with a schema:

  • overview
  • rules
  • rule: a rule's definition and history
  • incidents
  • firings: with their labels
  • outcomes

The seventh, compare, is the one an agent can't do by itself. The agent writes the changed rules as a Prometheus rule file. Lapilli replays them, as they are and as proposed, against the metrics' history over the days before (up to 14), and judges both against the ledger's incidents. A comparison takes 20 rules at most and answers within 25 seconds. It answers with how often each rule would have fired, and which incidents it would have caught, sooner or later or not at all. The agent proposes and Lapilli measures. Once the change is merged, outcomes says whether it did what compare said.

Nothing an agent asks for changes anything: compare replays and keeps nothing. With --mcp-propose editors (or admins), an eighth tool, propose, keeps a change to one rule, or to what it says, as a proposal (Changing rules), marked as an agent's, for someone other than the person it acts for to approve in the UI, and backtest_again backtests a stale proposal again, as an editor does from its page. No tool approves or applies one.

  • Access. Agents come through the same sign-in as the pages (with --oidc-issuer, an ID token as a bearer token), and everyone gets the tools that read. compare runs PromQL the agent wrote with Lapilli's access to Prometheus, and, for a rule kept in Loki, LogQL the agent wrote, sent to the Loki (or through Grafana's data source proxy) with Lapilli's token, so only those --mcp-compare names get it, and one comparison runs at a time.
  • Browsers. Requests from web pages are refused: a browser sends an Origin, an agent doesn't. The one exception is a request from --external-url.
  • Text people wrote. Incident titles, notes and labels reach the agent as people wrote them, and the server tells it to treat them as data.

This page is copied from docs/mcp.md, where it is changed: a pull request there changes it here.

Clone this wiki locally