---
title: MC Chat Bot (Mission Control alerts posted into Team Chat)
---

# MC Chat Bot (Mission Control → Team Chat bridge)

## What it is

A bot that posts Mission Control project-health alerts into a Team Chat channel so your team sees project risks without opening Mission Control.

### What it does

The MC Chat Bot monitors your Mission Control boards and automatically posts categorized alerts into a designated Team Chat channel. It surfaces five categories of project intelligence:

- **at-risk** — items flagged as at risk of missing their deadline or target
- **cascade** — cascading delays where one slip affects downstream items
- **pattern** — detected patterns in project data (recurring blockers, velocity anomalies)
- **health-drop** — a board's overall health score dropped significantly
- **digest** — periodic summary of board activity and status

Each alert carries a severity level — `info`, `warning`, or `critical` — and the bot only posts alerts at or above your configured severity threshold (default: `warning`).

## Where to find it

Set it up in **Settings → Team & Admin → MC Chat Bot**. The alerts it posts land in whichever Team Chat channel you name there, so the bot itself has no panel of its own.

## How it behaves

### How to set it up

**Settings → Team & Admin → MC Chat Bot** (or the `mcChatBot*` settings):

| Setting | Default | What it does |
|---|---|---|
| `mcChatBotEnabled` | `false` | Master on/off toggle |
| `mcChatBotChannelId` | `''` | The Team Chat channel to post into |
| `mcChatBotMode` | `event-driven` | `event-driven` (post as events happen), `digest` (periodic summary only), or `both` |
| `mcChatBotSeverityThreshold` | `warning` | Minimum severity to post (`info` / `warning` / `critical`) |

### How it works

The bot runs in the main process and listens for Mission Control intelligence events. When an event matches the configured mode and meets the severity threshold, it composes a message and posts it to the designated Team Chat channel via the `TEAM_CHAT_MC_BOT_RECEIVED` push channel. The push payload carries the channel id, message text, bot name, category, severity, and the board ids involved.

## For agents

### Key files

- `src/shared/types/settings/mc-chat-bot-settings.ts` — Zod schema + defaults
- `src/shared/push-event-schemas/team-chat-mc-bot.ts` — push-event payload schema
- `src/shared/ipc-channels/team-chat.ts` — IPC channel constants
- `src/shared/feature-registry/workflow-coach-and-providers.ts` — feature registry entry (`mc_chat_bot`)

## Related

- [mission-control.md](mission-control.md) — the boards whose health this bot reports on.
- [communication.md](communication.md) — Team Chat itself, where the alerts arrive.