MCP Prompts Reference -- cortex

July 30, 2026 ยท View on GitHub

cortex exposes reusable MCP prompts for common infrastructure debugging workflows. Prompts do not add new data access paths; they guide MCP clients to call the existing cortex tool actions in a useful order and to report evidence before conclusions.

Execution Rules

Every prompt is written as a bounded investigation runbook:

  • Start with cheap, scoped actions such as status, errors, tail, search, and timeline.
  • Use small result sets first: limit=5 for searches, limit=10 for summaries, and before=3 / after=3 for context.
  • For timeline, use bucket=minute for recent windows. The supported bucket values are minute, hour, and day.
  • Escalate broader or slower actions only after the first pass produces a specific question. Examples include stats, anomalies, patterns, compare, clock_skew, ingest_rate, and broad correlate calls.
  • Summarize representative evidence instead of pasting full JSON payloads.
  • Return a consistent synthesis with Verdict, Evidence, Likely Cause, Not Supported, Next Actions, and Telemetry Gaps.
  • Clients that support structured output can read cortex://schema/prompt-output and validate prompt answers against that JSON Schema.
PromptPurposeUseful arguments
infra.incident-triageBuild a timeline, scope, likely cause, and next actions for an incidentwindow, host, service
infra.host-healthCheck one host for silence, error spikes, clock skew, noisy apps, and source identity drifthost, window
infra.service-outageDebug a service, application, or container outage from service logs and nearby host eventsservice, host, window
infra.security-auth-reviewReview auth failures, bans, suspicious IPs, and correlated infrastructure contextwindow, actor, host
infra.noise-reductionIdentify repeated patterns and recommend safe alert tuning or source fixeswindow, host, service
infra.agent-change-correlationCorrelate AI agent work with infrastructure errors and regressionsproject, session_id, window, host, service
infra.docker-container-regressionInvestigate container restarts, healthchecks, image pulls, and Compose regressionscontainer, host, service, window
infra.network-dns-failureDebug DNS, proxy, firewall, upstream, and reachability failureshost, service, window
infra.storage-pressureInvestigate disk pressure, DB growth, cleanup, and write-block riskhost, service, window
infra.auth-bruteforceInvestigate repeated auth failures, bans, suspicious sources, and blast radiuswindow, actor, host, service
infra.syslog-forwarding-gapInvestigate stale, missing, spoofed, or delayed syslog forwardinghost, window
infra.after-deploy-checkVerify post-deploy health and identify regressions quicklyservice, host, window

Example

{
  "name": "infra.service-outage",
  "arguments": {
    "service": "plex",
    "host": "tootie",
    "window": "last 45 minutes"
  }
}

The rendered prompt asks the client to start with bounded search, errors, timeline, and context calls, then escalate to anomalies, compare, correlate, or Compose diagnostics only when the first pass leaves a concrete question.