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.6.tar.gz (97.7 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.6-py3-none-any.whl (77.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: incident_triage_mcp-0.2.6.tar.gz
  • Upload date:
  • Size: 97.7 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.6.tar.gz
Algorithm Hash digest
SHA256 46fce722bcac9097d1bcf0195bf41c24809ddea11f047754e525359b39096777
MD5 b21f5f9c4c15116e654636b822382c25
BLAKE2b-256 e349d2697783995a53db12fb7b3fb40547cd3eab97c929c1d5c45b7a747704f2

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for incident_triage_mcp-0.2.6-py3-none-any.whl
Algorithm Hash digest
SHA256 cb1f05c9272755e52f527fbd99a77a10cb53dfe453c452c987af3d071c69086d
MD5 90ad616a300dbefffc8092a36b89950d
BLAKE2b-256 d4dfbb14cd29fcb1e87f8ef7598c32355e7452c4fcd2883fcc70bb83f5908e60

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