Skip to main content

Model Context Protocol server for evidence-driven incident triage with safe actions and workflow integrations.

Project description

incident-triage-mcp

incident-triage-mcp is a Model Context Protocol (MCP) server for incident response workflows.

It exposes auditable, tool-based incident triage capabilities that AI hosts/agents can call over MCP (stdio or streamable-http) without giving the model direct infrastructure access.

What It Provides

  • MCP tools for incident triage and evidence retrieval
  • Deterministic incident summaries from normalized evidence bundles
  • Safe action gating (RBAC, confirm tokens, audit logging)
  • Ticketing integrations (Jira / ServiceNow)
  • Notification integrations (Slack / Teams)
  • Optional Airflow workflow trigger integration
  • Standalone mode (no Airflow required)

Typical Architecture

  • Agent/LLM host calls MCP tools only
  • MCP server enforces guardrails and orchestrates triage actions
  • Airflow (optional) collects/normalizes evidence into an EvidenceBundle v1
  • Evidence backend can be filesystem (local) or S3-compatible storage (prod)

Install

pip install incident-triage-mcp

Optional AWS extras (S3 / CloudWatch / X-Ray related integrations):

pip install "incident-triage-mcp[aws]"

Run

MCP server (stdio)

MCP_TRANSPORT=stdio incident-triage-mcp

MCP server (HTTP)

MCP_TRANSPORT=streamable-http MCP_HTTP_AUTH_MODE=api_key MCP_HTTP_API_KEY=change-me incident-triage-mcp

Local LangGraph agent CLI

incident-triage-agent --incident-id INC-123 --service payments-api

Core Configuration (overview)

  • WORKFLOW_BACKEND=none|airflow
  • EVIDENCE_BACKEND=fs|s3|none (legacy airflow mode still supported)
  • MCP_TRANSPORT=stdio|streamable-http
  • MCP_HTTP_AUTH_MODE=none|api_key|jwt_hs256
  • JIRA_PROVIDER=mock|cloud|servicenow
  • NOTIFY_PROVIDER=slack|teams

Project Links

For full setup (Docker, Kubernetes, Airflow, Helm, provider configs, and demos), see the repository README.md.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

incident_triage_mcp-0.2.9.tar.gz (97.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

incident_triage_mcp-0.2.9-py3-none-any.whl (80.5 kB view details)

Uploaded Python 3

File details

Details for the file incident_triage_mcp-0.2.9.tar.gz.

File metadata

  • Download URL: incident_triage_mcp-0.2.9.tar.gz
  • Upload date:
  • Size: 97.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for incident_triage_mcp-0.2.9.tar.gz
Algorithm Hash digest
SHA256 b2d31d2e68fe18116ebe64cc970a50f76dbceba7fbaee378ffe67f686c86d779
MD5 6b67b66ad5738f4b19ae8b7bcb5a0885
BLAKE2b-256 5cce95d7a24c3e988ed70403c059df5eb6b0cc424f1fd584dd6c07ff5a1dc0b6

See more details on using hashes here.

File details

Details for the file incident_triage_mcp-0.2.9-py3-none-any.whl.

File metadata

File hashes

Hashes for incident_triage_mcp-0.2.9-py3-none-any.whl
Algorithm Hash digest
SHA256 c63a447142a2b9fb7bc537dc3d5461f317480ad8b6bee96f4a78fdfbe8082bcc
MD5 e0ab7afb72377cc7963a3f3ba83bca03
BLAKE2b-256 38cf99527faf878e5cc06de17b77c4273527d3a56478ab316acbb84e5120e856

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page