DevHelm MCP Server

Official

Overview Schema Source Related Servers Discussions Admin

create_alert_channel

Create an alert channel to send incident notifications to email, Slack, webhook, or other services. Configure name, type, and provider details to start receiving alerts.

Instructions

Create a new alert channel.

Required: name, type, config (type-specific). Types: EMAIL, WEBHOOK, SLACK, PAGERDUTY, OPSGENIE, TEAMS, DISCORD, TELEGRAM, GOOGLE_CHAT, PUSHOVER, MATTERMOST, SPLUNK_ONCALL, PUSHBULLET, LINEAR, INCIDENT_IO, ROOTLY, ZAPIER, DATADOG, JIRA, GITLAB.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`body`	Yes

Output Schema

TableJSON Schema

Name	Required	Description	Default
`result`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedv1.7.0Aug 26, 2026

changedInput schema / properties / body / properties / config / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "apiKey": {
-        "description": "Datadog API key",
-        "minLength": 1,
-        "type": "string"
-      },
-      "channelType": {
-        "const": "datadog",
-        "default": "datadog",
-        "type": "string"
-      },
-      "site": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Datadog site region (e.g. datadoghq.com, datadoghq.eu, us3.datadoghq.com)"
-      },
-      "tags": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Comma-separated tags to attach to events"
-      }
-    },
-    "required": [
-      "apiKey"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "channelType": {
-        "const": "discord",
-        "default": "discord",
-        "type": "string"
-      },
-      "mentionRoleId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Optional Discord role ID to mention in notifications"
-      },
-      "webhookUrl": {
-        "description": "Discord webhook URL",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "webhookUrl"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "channelType": {
-        "const": "email",
-        "default": "email",
-        "type": "string"
-      },
-      "recipients": {
-        "description": "Email addresses to send notifications to",
-        "items": {
-          "format": "email",
-          "type": "string"
-        },
-        "minItems": 1,
-        "type": "array"
-      }
-    },
-    "required": [
-      "recipients"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "authorizationKey": {
-        "description": "Authorization key from GitLab alert integration settings",
-        "minLength": 1,
-        "type": "string"
-      },
-      "channelType": {
-        "const": "gitlab",
-        "default": "gitlab",
-        "type": "string"
-      },
-      "endpointUrl": {
-        "description": "GitLab alert integration endpoint URL",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "endpointUrl",
-      "authorizationKey"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "channelType": {
-        "const": "google_chat",
-        "default": "google_chat",
-        "type": "string"
-      },
-      "webhookUrl": {
-        "description": "Google Chat space webhook URL",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "webhookUrl"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "apiKey": {
-        "description": "incident.io API key with 'Create incidents' permission",
-        "minLength": 1,
-        "type": "string"
-      },
-      "channelType": {
-        "const": "incident_io",
-        "default": "incident_io",
-        "type": "string"
-      },
-      "severityId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Severity ID for created incidents (from List Severities API)"
-      },
-      "visibility": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Incident visibility: public or private (default: public)"
-      }
-    },
-    "required": [
-      "apiKey"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "apiToken": {
-        "description": "Atlassian API token",
-        "minLength": 1,
-        "type": "string"
-      },
-      "channelType": {
-        "const": "jira",
-        "default": "jira",
-        "type": "string"
-      },
-      "domain": {
-        "description": "Atlassian instance domain (e.g. yourteam.atlassian.net)",
-        "minLength": 1,
-        "type": "string"
-      },
-      "email": {
-        "description": "Atlassian account email for API authentication",
-        "minLength": 1,
-        "type": "string"
-      },
-      "issueType": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Issue type name (e.g. Bug, Task, Incident)"
-      },
-      "projectKey": {
-        "description": "Jira project key where issues are created (e.g. OPS)",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "domain",
-      "email",
-      "apiToken",
-      "projectKey"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "apiKey": {
-        "description": "Linear API key",
-        "minLength": 1,
-        "type": "string"
-      },
-      "channelType": {
-        "const": "linear",
-        "default": "linear",
-        "type": "string"
-      },
-      "labelId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Label ID to attach to created issues"
-      },
-      "teamId": {
-        "description": "Team ID to create issues in",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "apiKey",
-      "teamId"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "channel": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Override channel (if webhook allows)"
-      },
-      "channelType": {
-        "const": "mattermost",
-        "default": "mattermost",
-        "type": "string"
-      },
-      "iconUrl": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Custom bot icon URL"
-      },
-      "webhookUrl": {
-        "description": "Mattermost incoming webhook URL",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "webhookUrl"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "apiKey": {
-        "description": "OpsGenie API key for alert creation",
-        "minLength": 1,
-        "type": "string"
-      },
-      "channelType": {
-        "const": "opsgenie",
-        "default": "opsgenie",
-        "type": "string"
-      },
-      "region": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "OpsGenie API region: us or eu"
-      }
-    },
-    "required": [
-      "apiKey"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "channelType": {
-        "const": "pagerduty",
-        "default": "pagerduty",
-        "type": "string"
-      },
-      "routingKey": {
-        "description": "PagerDuty Events API v2 routing (integration) key",
-        "minLength": 1,
-        "type": "string"
-      },
-      "severityOverride": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Override PagerDuty severity mapping"
-      }
-    },
-    "required": [
-      "routingKey"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "accessToken": {
-        "description": "Pushbullet access token",
-        "minLength": 1,
-        "type": "string"
-      },
-      "channelType": {
-        "const": "pushbullet",
-        "default": "pushbullet",
-        "type": "string"
-      },
-      "deviceIden": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Target device identifier (broadcasts to all if empty)"
-      }
-    },
-    "required": [
-      "accessToken"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "appToken": {
-        "description": "Pushover application API token",
-        "minLength": 1,
-        "type": "string"
-      },
-      "channelType": {
-        "const": "pushover",
-        "default": "pushover",
-        "type": "string"
-      },
-      "priority": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Notification priority override (-2 to 2)"
-      },
-      "sound": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Notification sound override"
-      },
-      "userKey": {
-        "description": "Pushover user or group key",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "userKey",
-      "appToken"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "apiKey": {
-        "description": "Rootly API token with incident creation permission",
-        "minLength": 1,
-        "type": "string"
-      },
-      "channelType": {
-        "const": "rootly",
-        "default": "rootly",
-        "type": "string"
-      },
-      "severity": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Severity slug override (e.g. sev0, sev1)"
-      }
-    },
-    "required": [
-      "apiKey"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "channelType": {
-        "const": "slack",
-        "default": "slack",
-        "type": "string"
-      },
-      "mentionText": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Optional mention text included in notifications, e.g. @channel"
-      },
-      "webhookUrl": {
-        "description": "Slack incoming webhook URL",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "webhookUrl"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "apiKey": {
-        "description": "Splunk On-Call REST API key",
-        "minLength": 1,
-        "type": "string"
-      },
-      "channelType": {
-        "const": "splunk_oncall",
-        "default": "splunk_oncall",
-        "type": "string"
-      },
-      "routingKey": {
-        "description": "Routing key for alert routing",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "apiKey",
-      "routingKey"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "channelType": {
-        "const": "teams",
-        "default": "teams",
-        "type": "string"
-      },
-      "webhookUrl": {
-        "description": "Microsoft Teams incoming webhook URL",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "webhookUrl"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "botToken": {
-        "description": "Telegram bot token from @BotFather",
-        "minLength": 1,
-        "type": "string"
-      },
-      "channelType": {
-        "const": "telegram",
-        "default": "telegram",
-        "type": "string"
-      },
-      "chatId": {
-        "description": "Chat, group, or channel ID to send alerts to",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "botToken",
-      "chatId"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "channelType": {
-        "const": "webhook",
-        "default": "webhook",
-        "type": "string"
-      },
-      "customHeaders": {
-        "anyOf": [
-          {
-            "additionalProperties": {
-              "type": "string"
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Additional HTTP headers to include in webhook requests"
-      },
-      "signingSecret": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Optional HMAC signing secret for payload verification"
-      },
-      "url": {
-        "description": "Webhook endpoint URL that receives alert payloads",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "url"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "channelType": {
-        "const": "zapier",
-        "default": "zapier",
-        "type": "string"
-      },
-      "webhookUrl": {
-        "description": "Zapier/n8n/Make catch webhook URL",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "webhookUrl"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "apiKey": {
+        "description": "Datadog API key",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "datadog",
+        "default": "datadog",
+        "type": "string"
+      },
+      "site": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Datadog site region (e.g. datadoghq.com, datadoghq.eu, us3.datadoghq.com)"
+      },
+      "tags": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Comma-separated tags to attach to events"
+      }
+    },
+    "required": [
+      "apiKey"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "channelType": {
+        "const": "discord",
+        "default": "discord",
+        "type": "string"
+      },
+      "mentionRoleId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Optional Discord role ID to mention in notifications"
+      },
+      "webhookUrl": {
+        "description": "Discord webhook URL",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "webhookUrl"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "channelType": {
+        "const": "email",
+        "default": "email",
+        "type": "string"
+      },
+      "recipients": {
+        "description": "Email addresses to send notifications to",
+        "items": {
+          "format": "email",
+          "type": "string"
+        },
+        "minItems": 1,
+        "type": "array"
+      }
+    },
+    "required": [
+      "recipients"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "authorizationKey": {
+        "description": "Authorization key from GitLab alert integration settings",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "gitlab",
+        "default": "gitlab",
+        "type": "string"
+      },
+      "endpointUrl": {
+        "description": "GitLab alert integration endpoint URL",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "endpointUrl",
+      "authorizationKey"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "channelType": {
+        "const": "google_chat",
+        "default": "google_chat",
+        "type": "string"
+      },
+      "webhookUrl": {
+        "description": "Google Chat space webhook URL",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "webhookUrl"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "apiKey": {
+        "description": "incident.io API key with 'Create incidents' permission",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "incident_io",
+        "default": "incident_io",
+        "type": "string"
+      },
+      "severityId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Severity ID for created incidents (from List Severities API)"
+      },
+      "visibility": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Incident visibility: public or private (default: public)"
+      }
+    },
+    "required": [
+      "apiKey"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "apiToken": {
+        "description": "Atlassian API token",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "jira",
+        "default": "jira",
+        "type": "string"
+      },
+      "domain": {
+        "description": "Atlassian instance domain (e.g. yourteam.atlassian.net)",
+        "minLength": 1,
+        "type": "string"
+      },
+      "email": {
+        "description": "Atlassian account email for API authentication",
+        "minLength": 1,
+        "type": "string"
+      },
+      "issueType": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Issue type name (e.g. Bug, Task, Incident)"
+      },
+      "projectKey": {
+        "description": "Jira project key where issues are created (e.g. OPS)",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "domain",
+      "email",
+      "apiToken",
+      "projectKey"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "apiKey": {
+        "description": "Linear API key",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "linear",
+        "default": "linear",
+        "type": "string"
+      },
+      "labelId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Label ID to attach to created issues"
+      },
+      "teamId": {
+        "description": "Team ID to create issues in",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "apiKey",
+      "teamId"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "channel": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Override channel (if webhook allows)"
+      },
+      "channelType": {
+        "const": "mattermost",
+        "default": "mattermost",
+        "type": "string"
+      },
+      "iconUrl": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Custom bot icon URL"
+      },
+      "webhookUrl": {
+        "description": "Mattermost incoming webhook URL",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "webhookUrl"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "apiKey": {
+        "description": "OpsGenie API key for alert creation",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "opsgenie",
+        "default": "opsgenie",
+        "type": "string"
+      },
+      "region": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "OpsGenie API region: us or eu"
+      }
+    },
+    "required": [
+      "apiKey"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "channelType": {
+        "const": "pagerduty",
+        "default": "pagerduty",
+        "type": "string"
+      },
+      "routingKey": {
+        "description": "PagerDuty Events API v2 routing (integration) key",
+        "minLength": 1,
+        "type": "string"
+      },
+      "severityOverride": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Override PagerDuty severity mapping"
+      }
+    },
+    "required": [
+      "routingKey"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "channelType": {
+        "const": "phone_call",
+        "default": "phone_call",
+        "type": "string"
+      },
+      "phoneNumber": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Recipient phone number in E.164 format, e.g. +14155550123"
+      },
+      "phoneNumbers": {
+        "anyOf": [
+          {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Deprecated: use phoneNumber. Accepted as a length-1 list for one release; ignored when phoneNumber or id is set"
+      },
+      "preferredLanguage": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Preferred language for TTS and notifications (BCP-47, e.g. en-US, de-DE). Alias for voiceLanguage"
+      },
+      "verifiedPhoneNumberId": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Id of an org verified_phone_number row; alternative to phoneNumber"
+      },
+      "voiceLanguage": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "TTS voice language/locale (default: en-US). See VoiceLanguage for supported values"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "properties": {
+      "accessToken": {
+        "description": "Pushbullet access token",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "pushbullet",
+        "default": "pushbullet",
+        "type": "string"
+      },
+      "deviceIden": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Target device identifier (broadcasts to all if empty)"
+      }
+    },
+    "required": [
+      "accessToken"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "appToken": {
+        "description": "Pushover application API token",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "pushover",
+        "default": "pushover",
+        "type": "string"
+      },
+      "priority": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Notification priority override (-2 to 2)"
+      },
+      "sound": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Notification sound override"
+      },
+      "userKey": {
+        "description": "Pushover user or group key",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "userKey",
+      "appToken"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "apiKey": {
+        "description": "Rootly API token with incident creation permission",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "rootly",
+        "default": "rootly",
+        "type": "string"
+      },
+      "severity": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Severity slug override (e.g. sev0, sev1)"
+      }
+    },
+    "required": [
+      "apiKey"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "channelType": {
+        "const": "slack",
+        "default": "slack",
+        "type": "string"
+      },
+      "mentionText": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Optional mention text included in notifications, e.g. @channel"
+      },
+      "webhookUrl": {
+        "description": "Slack incoming webhook URL",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "webhookUrl"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "channelType": {
+        "const": "sms",
+        "default": "sms",
+        "type": "string"
+      },
+      "phoneNumber": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Recipient phone number in E.164 format, e.g. +14155550123"
+      },
+      "phoneNumbers": {
+        "anyOf": [
+          {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Deprecated: use phoneNumber. Accepted as a length-1 list for one release; ignored when phoneNumber or id is set"
+      },
+      "preferredLanguage": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Preferred language for SMS body (BCP-47, e.g. en-US, de-DE). Default: en-US"
+      },
+      "verifiedPhoneNumberId": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Id of an org verified_phone_number row; alternative to phoneNumber"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "properties": {
+      "apiKey": {
+        "description": "Splunk On-Call REST API key",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "splunk_oncall",
+        "default": "splunk_oncall",
+        "type": "string"
+      },
+      "routingKey": {
+        "description": "Routing key for alert routing",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "apiKey",
+      "routingKey"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "channelType": {
+        "const": "teams",
+        "default": "teams",
+        "type": "string"
+      },
+      "webhookUrl": {
+        "description": "Microsoft Teams incoming webhook URL",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "webhookUrl"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "botToken": {
+        "description": "Telegram bot token from @BotFather",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "telegram",
+        "default": "telegram",
+        "type": "string"
+      },
+      "chatId": {
+        "description": "Chat, group, or channel ID to send alerts to",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "botToken",
+      "chatId"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "channelType": {
+        "const": "webhook",
+        "default": "webhook",
+        "type": "string"
+      },
+      "customHeaders": {
+        "anyOf": [
+          {
+            "additionalProperties": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Additional HTTP headers to include in webhook requests"
+      },
+      "signingSecret": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "HMAC secret for X-DevHelm-Signature header; omit for unsigned delivery"
+      },
+      "url": {
+        "description": "Webhook endpoint URL that receives alert payloads",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "url"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "channelType": {
+        "const": "zapier",
+        "default": "zapier",
+        "type": "string"
+      },
+      "webhookUrl": {
+        "description": "Zapier/n8n/Make catch webhook URL",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "webhookUrl"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedv1.4.0Jun 18, 2026

changedInput schema / properties / body / properties / config / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "channelType": {
-        "const": "discord",
-        "default": "discord",
-        "type": "string"
-      },
-      "mentionRoleId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Optional Discord role ID to mention in notifications"
-      },
-      "webhookUrl": {
-        "description": "Discord webhook URL",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "webhookUrl"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "channelType": {
-        "const": "email",
-        "default": "email",
-        "type": "string"
-      },
-      "recipients": {
-        "description": "Email addresses to send notifications to",
-        "items": {
-          "format": "email",
-          "type": "string"
-        },
-        "minItems": 1,
-        "type": "array"
-      }
-    },
-    "required": [
-      "recipients"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "apiKey": {
-        "description": "OpsGenie API key for alert creation",
-        "minLength": 1,
-        "type": "string"
-      },
-      "channelType": {
-        "const": "opsgenie",
-        "default": "opsgenie",
-        "type": "string"
-      },
-      "region": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "OpsGenie API region: us or eu"
-      }
-    },
-    "required": [
-      "apiKey"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "channelType": {
-        "const": "pagerduty",
-        "default": "pagerduty",
-        "type": "string"
-      },
-      "routingKey": {
-        "description": "PagerDuty Events API v2 routing (integration) key",
-        "minLength": 1,
-        "type": "string"
-      },
-      "severityOverride": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Override PagerDuty severity mapping"
-      }
-    },
-    "required": [
-      "routingKey"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "channelType": {
-        "const": "slack",
-        "default": "slack",
-        "type": "string"
-      },
-      "mentionText": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Optional mention text included in notifications, e.g. @channel"
-      },
-      "webhookUrl": {
-        "description": "Slack incoming webhook URL",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "webhookUrl"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "channelType": {
-        "const": "teams",
-        "default": "teams",
-        "type": "string"
-      },
-      "webhookUrl": {
-        "description": "Microsoft Teams incoming webhook URL",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "webhookUrl"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "channelType": {
-        "const": "webhook",
-        "default": "webhook",
-        "type": "string"
-      },
-      "customHeaders": {
-        "anyOf": [
-          {
-            "additionalProperties": {
-              "type": "string"
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Additional HTTP headers to include in webhook requests"
-      },
-      "signingSecret": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Optional HMAC signing secret for payload verification"
-      },
-      "url": {
-        "description": "Webhook endpoint URL that receives alert payloads",
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "url"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "apiKey": {
+        "description": "Datadog API key",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "datadog",
+        "default": "datadog",
+        "type": "string"
+      },
+      "site": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Datadog site region (e.g. datadoghq.com, datadoghq.eu, us3.datadoghq.com)"
+      },
+      "tags": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Comma-separated tags to attach to events"
+      }
+    },
+    "required": [
+      "apiKey"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "channelType": {
+        "const": "discord",
+        "default": "discord",
+        "type": "string"
+      },
+      "mentionRoleId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Optional Discord role ID to mention in notifications"
+      },
+      "webhookUrl": {
+        "description": "Discord webhook URL",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "webhookUrl"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "channelType": {
+        "const": "email",
+        "default": "email",
+        "type": "string"
+      },
+      "recipients": {
+        "description": "Email addresses to send notifications to",
+        "items": {
+          "format": "email",
+          "type": "string"
+        },
+        "minItems": 1,
+        "type": "array"
+      }
+    },
+    "required": [
+      "recipients"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "authorizationKey": {
+        "description": "Authorization key from GitLab alert integration settings",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "gitlab",
+        "default": "gitlab",
+        "type": "string"
+      },
+      "endpointUrl": {
+        "description": "GitLab alert integration endpoint URL",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "endpointUrl",
+      "authorizationKey"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "channelType": {
+        "const": "google_chat",
+        "default": "google_chat",
+        "type": "string"
+      },
+      "webhookUrl": {
+        "description": "Google Chat space webhook URL",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "webhookUrl"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "apiKey": {
+        "description": "incident.io API key with 'Create incidents' permission",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "incident_io",
+        "default": "incident_io",
+        "type": "string"
+      },
+      "severityId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Severity ID for created incidents (from List Severities API)"
+      },
+      "visibility": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Incident visibility: public or private (default: public)"
+      }
+    },
+    "required": [
+      "apiKey"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "apiToken": {
+        "description": "Atlassian API token",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "jira",
+        "default": "jira",
+        "type": "string"
+      },
+      "domain": {
+        "description": "Atlassian instance domain (e.g. yourteam.atlassian.net)",
+        "minLength": 1,
+        "type": "string"
+      },
+      "email": {
+        "description": "Atlassian account email for API authentication",
+        "minLength": 1,
+        "type": "string"
+      },
+      "issueType": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Issue type name (e.g. Bug, Task, Incident)"
+      },
+      "projectKey": {
+        "description": "Jira project key where issues are created (e.g. OPS)",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "domain",
+      "email",
+      "apiToken",
+      "projectKey"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "apiKey": {
+        "description": "Linear API key",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "linear",
+        "default": "linear",
+        "type": "string"
+      },
+      "labelId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Label ID to attach to created issues"
+      },
+      "teamId": {
+        "description": "Team ID to create issues in",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "apiKey",
+      "teamId"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "channel": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Override channel (if webhook allows)"
+      },
+      "channelType": {
+        "const": "mattermost",
+        "default": "mattermost",
+        "type": "string"
+      },
+      "iconUrl": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Custom bot icon URL"
+      },
+      "webhookUrl": {
+        "description": "Mattermost incoming webhook URL",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "webhookUrl"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "apiKey": {
+        "description": "OpsGenie API key for alert creation",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "opsgenie",
+        "default": "opsgenie",
+        "type": "string"
+      },
+      "region": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "OpsGenie API region: us or eu"
+      }
+    },
+    "required": [
+      "apiKey"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "channelType": {
+        "const": "pagerduty",
+        "default": "pagerduty",
+        "type": "string"
+      },
+      "routingKey": {
+        "description": "PagerDuty Events API v2 routing (integration) key",
+        "minLength": 1,
+        "type": "string"
+      },
+      "severityOverride": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Override PagerDuty severity mapping"
+      }
+    },
+    "required": [
+      "routingKey"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "accessToken": {
+        "description": "Pushbullet access token",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "pushbullet",
+        "default": "pushbullet",
+        "type": "string"
+      },
+      "deviceIden": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Target device identifier (broadcasts to all if empty)"
+      }
+    },
+    "required": [
+      "accessToken"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "appToken": {
+        "description": "Pushover application API token",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "pushover",
+        "default": "pushover",
+        "type": "string"
+      },
+      "priority": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Notification priority override (-2 to 2)"
+      },
+      "sound": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Notification sound override"
+      },
+      "userKey": {
+        "description": "Pushover user or group key",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "userKey",
+      "appToken"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "apiKey": {
+        "description": "Rootly API token with incident creation permission",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "rootly",
+        "default": "rootly",
+        "type": "string"
+      },
+      "severity": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Severity slug override (e.g. sev0, sev1)"
+      }
+    },
+    "required": [
+      "apiKey"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "channelType": {
+        "const": "slack",
+        "default": "slack",
+        "type": "string"
+      },
+      "mentionText": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Optional mention text included in notifications, e.g. @channel"
+      },
+      "webhookUrl": {
+        "description": "Slack incoming webhook URL",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "webhookUrl"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "apiKey": {
+        "description": "Splunk On-Call REST API key",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "splunk_oncall",
+        "default": "splunk_oncall",
+        "type": "string"
+      },
+      "routingKey": {
+        "description": "Routing key for alert routing",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "apiKey",
+      "routingKey"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "channelType": {
+        "const": "teams",
+        "default": "teams",
+        "type": "string"
+      },
+      "webhookUrl": {
+        "description": "Microsoft Teams incoming webhook URL",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "webhookUrl"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "botToken": {
+        "description": "Telegram bot token from @BotFather",
+        "minLength": 1,
+        "type": "string"
+      },
+      "channelType": {
+        "const": "telegram",
+        "default": "telegram",
+        "type": "string"
+      },
+      "chatId": {
+        "description": "Chat, group, or channel ID to send alerts to",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "botToken",
+      "chatId"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "channelType": {
+        "const": "webhook",
+        "default": "webhook",
+        "type": "string"
+      },
+      "customHeaders": {
+        "anyOf": [
+          {
+            "additionalProperties": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Additional HTTP headers to include in webhook requests"
+      },
+      "signingSecret": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Optional HMAC signing secret for payload verification"
+      },
+      "url": {
+        "description": "Webhook endpoint URL that receives alert payloads",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "url"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "channelType": {
+        "const": "zapier",
+        "default": "zapier",
+        "type": "string"
+      },
+      "webhookUrl": {
+        "description": "Zapier/n8n/Make catch webhook URL",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "webhookUrl"
+    ],
+    "type": "object"
+  }
+]

First observedv1.0.2May 12, 2026

TDQS

B3.2/5.0

Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It only says 'Create' and lists requirements; it does not disclose side effects, credential validation behavior, whether channels are persisted immediately, or what happens on invalid type-specific config. This is thin for a mutation tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is short, front-loaded with the core action, and the type list is readable. Every line earns its place, though the misleading 'type' wording slightly undermines the efficiency.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has a large, nested oneOf config schema and no annotations, so the description needed to do more orienting work. It provides a useful type list but omits two valid types, misrepresents the required top-level shape, and does not explain that the type is selected through config.channelType. The output schema exists, so return details are less critical, but the input-shape ambiguity is a significant completeness gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description names 'name, type, config (type-specific)' and lists supported types, which is helpful orientation. However, it misleadingly calls 'type' a required top-level field—there is no `type` property in the schema; the type is expressed via `config.channelType`. It also omits SMS and PHONE_CALL from the type list and says nothing about the `managedBy` parameter, so it only partially compensates for the schema's reported 0% description coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific action and resource: 'Create a new alert channel.' The verb 'Create' and noun 'alert channel' clearly distinguish this from sibling tools like get_alert_channel, update_alert_channel, and delete_alert_channel, even though create_webhook overlaps conceptually.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives useful context about required inputs and supported channel types, so an agent can infer this tool is for creating alert channels. However, it provides no explicit guidance about when to use this instead of a sibling like create_webhook, nor any exclusions or preconditions beyond the required-fields note.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server