frontmcp-channels

name	frontmcp-channels
description	Use when pushing real-time notifications or events into Claude Code (or another MCP client) sessions, or building two-way chat bridges. Covers channel source types: incoming webhooks (such as GitHub), app error events, agent-completion and job-completion alerts, service connectors, file watchers, and replay buffers; plus two-way conversational bridges connecting WhatsApp, Telegram, Slack, and Discord to a Claude Code session. Triggers: push notifications, real-time alerts, webhook channel, chat bridge, WhatsApp / Telegram / Slack / Discord, agent completion alert, job status notification, error forwarding, server-to-client messaging. The skill for CHANNELS and NOTIFICATIONS.
when_to_use	Trigger when creating or editing a *.channel.ts file, or building a channel that pushes real-time notifications into a Claude Code session: webhook sources, app / agent / job event alerts, service connectors, file watchers, or a two-way chat bridge (WhatsApp, Telegram, Slack, Discord).
paths	**/*.channel.ts
tags	["channels","notifications","claude-code","webhooks","messaging","real-time","two-way"]
category	development
targets	["all"]
bundle	["full"]
priority	8
visibility	both
license	Apache-2.0
metadata	{"docs":"https://code.claude.com/docs/en/channels-reference"}

FrontMCP Channels

Build push-based notification channels that stream real-time events into Claude Code. Channels let your MCP server forward webhooks, application errors, agent completions, job results, and chat messages directly into Claude's context, with optional two-way reply support.

When to Use This Skill

Must Use

• You need Claude Code to react to external events (CI failures, monitoring alerts, deploy status)
• You are building a chat bridge (WhatsApp, Telegram, Slack, Discord) for Claude Code
• You want agents or background jobs to notify Claude Code upon completion

Recommended

• You want to forward application errors to Claude for debugging assistance
• You need a messaging interface where remote users can interact with Claude via chat platforms

Skip When

• You only need standard MCP resource subscriptions (use @Resource with resources/subscribe)
• Your client is not Claude Code and does not support experimental['claude/channel']
• You need request-response patterns (use @Tool instead)

Decision: Use channels when you need server-initiated push notifications into Claude Code. Use resources when the client pulls data on demand.

Prerequisites

• @frontmcp/sdk >= 1.0.0
• Basic understanding of @FrontMcp, @App, and @Tool decorators
• For webhook sources: HTTP transport (not stdio-only)
• For chat bridges: external API credentials (WhatsApp Business API, Telegram Bot Token, etc.)

Steps

1. Choose your channel source type from the Scenario Routing Table
2. Create a channel class or function
3. Register it in your app
4. Enable channels in @FrontMcp config
5. Test with Claude Code using --dangerously-load-development-channels

Scenario Routing Table

Scenario	Reference	Description
Webhook alerts (CI, monitoring)	references/channel-sources.md	Forward HTTP webhooks into Claude
Application error forwarding