What is send-discord-notification?

This Claude skill enables seamless integration with Discord to send rich-formatted notifications via the Discord MCP server. It allows for automated delivery of color-coded embeds, supporting various message types such as system health reports, critical issue alerts, and security escalations to keep teams synchronized and responsive.

When should I use send-discord-notification?

send-discord-notification is useful in the following scenarios: • DevOps & SRE Alerting: Automatically post real-time alerts for Kubernetes pod failures or infrastructure issues directly to engineering channels with severity-based color coding. • System Health Monitoring: Generate and send automated daily status reports or 'heartbeat' notifications to ensure all services are operational. • Incident Response & Escalation: Route high-priority investigation results or security escalations to specific Discord channels for immediate human intervention and visibility. • Workflow Automation: Integrate with CI/CD pipelines or other automated tasks to notify stakeholders of successful deployments or build failures.

name	send-discord-notification
version	"2.0.0"
description	>
notification types	health reports, issue alerts, investigation results,
and escalations. Uses channel names for routing. Keywords	Discord,
domain	general
category	notifications
requires-approval	false
confidence	0.95
skills	[]
tools	[]
timeout	30s
retries	2
backoff	exponential

Send Discord Notification

Send notifications to Discord using the Discord MCP server.

When to Use

Need to notify humans about status changes or alerts
Want to post rich formatted messages with embeds
Sending health reports, issue alerts, or investigation results
Keywords: discord, notify, alert, message, post

Prerequisites

Before applying this skill, verify:

DISCORD_MCP_URL environment variable is set (or use default)
Target channel exists in the Discord server
Message content or embed data is available

Input Schema

{
  "type": "string - Notification type: health | issue | investigation | success | failure | escalation",
  "title": "string - Notification title",
  "description": "string - Main message content",
  "channel_name": "string - Target channel (default: kubani-alerts)",
  "resource": "string - Optional resource identifier",
  "namespace": "string - Optional Kubernetes namespace",
  "severity": "string - Optional severity: low | medium | high | critical",
  "fields": "array - Optional additional fields [{name, value, inline}]"
}

Actions

1. Determine Notification Type and Color

Map notification type to Discord embed color:

Type	Color	Hex
health	Green	0x57F287
success	Green	0x57F287
issue	Orange	0xF39C12
investigation	Blue	0x5865F2
failure	Red	0xED4245
escalation	Red	0xED4245

2. Build Discord Embed

mcp_tool: discord-mcp-server/send_message_to_channel_name
params:
  channel_name: $channel_name
  embed:
    title: $title
    description: $description
    color: $type_color
    fields: $fields
    footer:
      text: "Kubani AI Agent"
    timestamp: $current_timestamp
timeout: 30s
on_error: retry

3. Send Message

Use the Discord MCP server to send the formatted message.

mcp_tool: discord-mcp-server/send_message_to_channel_name
params:
  channel_name: $channel_name
  content: $plain_text_content  # Optional, if no embed
  embed: $formatted_embed       # Optional, for rich messages

Output Schema

{
  "status": "success | failed",
  "message_id": "string - Discord message ID if successful",
  "channel": "string - Channel where message was posted",
  "error": "string - Error message if failed"
}

Success Criteria

The skill succeeds when:

Message ID returned from Discord MCP server
No error in response
Message appears in target channel

Failure Handling

Error Type	Handling Strategy
Channel not found	Log error, check channel name
MCP server unavailable	Retry with exponential backoff
Rate limited	Wait and retry
Permission denied	Escalate to human

Examples

Example 1: Issue Alert

Input:

{
  "type": "issue",
  "title": "CrashLoopBackOff Detected",
  "description": "Pod has restarted 5 times in the last 10 minutes",
  "channel_name": "kubani-alerts",
  "resource": "nginx-deployment-abc123",
  "namespace": "production",
  "severity": "high"
}

MCP Tool Call:

mcp_tool: discord-mcp-server/send_message_to_channel_name
params:
  channel_name: kubani-alerts
  embed:
    title: "⚠️ CrashLoopBackOff Detected"
    description: "Pod has restarted 5 times in the last 10 minutes"
    color: 15908140  # Orange
    fields:
      - name: "Resource"
        value: "nginx-deployment-abc123"
        inline: true
      - name: "Namespace"
        value: "production"
        inline: true
      - name: "Severity"
        value: "HIGH"
        inline: true
    footer:
      text: "Kubani K8s Monitor"

Example 2: Health Report