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.8.tar.gz (98.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.8-py3-none-any.whl (77.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: incident_triage_mcp-0.2.8.tar.gz
  • Upload date:
  • Size: 98.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.8.tar.gz
Algorithm Hash digest
SHA256 6fa35f084dc0c3c213d682b9f8757dcd2dbedc720c0ada614e313454b4e0b34e
MD5 69e4f4bb6b7d239b097af71530b0f942
BLAKE2b-256 818a8d27fd1312f6d88bf602dcad183ed3f6aee65c34dcf3bbe5802af693ac55

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for incident_triage_mcp-0.2.8-py3-none-any.whl
Algorithm Hash digest
SHA256 6065d832ab00e54649c8a153375a60dfd4ad17e24a7b1f47d4d5211695cd503e
MD5 f414c4dbd280cf481ebf28e81c1d1402
BLAKE2b-256 5fea19494ad46ba98909435634adefb5d83d02bafb738aa180826e46dcaca0d1

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