Incident Triage Agent

A deliberately small TypeScript project demonstrating two things:

1. A custom Model Context Protocol (MCP) server that exposes validated backend-operations tools.
2. An AI agent that discovers and invokes those MCP tools to investigate a sample incident.

This is a portfolio project, not a production monitoring platform.

What it does

The agent can inspect local sample data through two read-only MCP tools:

• get_service_health — returns service status, latency, error rate, and dependency information.
• search_logs — filters recent logs by service, severity, text, or trace ID.

The agent then produces an evidence-based incident summary with a likely cause and next action.

Architecture

User prompt
    |
OpenAI Agents SDK
    |
MCP client over stdio
    |
Custom TypeScript MCP server
    |
In-memory service-health and log data

Why the scope is intentionally small

Included:

• One CLI agent
• One local MCP server
• Two read-only tools
• Zod input validation
• Sample operational data
• Unit tests
• Error handling and server cleanup

Not included:

• Web UI
• Database
• Authentication
• Cloud deployment
• Message queues
• Vector database
• Multi-agent orchestration

Those additions would make the project easier to abandon without making the résumé claim much stronger.

Requirements

• Node.js 20 or newer
• An OpenAI API key

Setup

npm install
cp .env.example .env

Add your API key to .env.

Run the tests

npm test

Run the agent

npm run agent -- "Investigate the learning-api degradation and recommend the safest next action."

Try another prompt:

npm run agent -- "Which service is unhealthy, and what log evidence supports the diagnosis?"