DevHelm MCP Server

Official

Overview Schema Related Servers Score Discussions

update_alert_channel

Update an existing alert channel by replacing its name, type, or provider-specific configuration to correct delivery settings. Resolve misconfigured notifications without deleting and recreating the channel.

Instructions

Update an existing alert channel.

Updatable fields: name, type, config (type-specific). See create_alert_channel for supported types.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`body`	Yes
`channel_id`	Yes

Output Schema

TableJSON Schema

Name	Required	Description	Default
`result`	Yes

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

Changed2 schema fields 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": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Datadog API key"
+      },
+      "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"
+      }
+    },
+    "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": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Discord webhook URL"
+      }
+    },
+    "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": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Authorization key from GitLab alert integration settings"
+      },
+      "channelType": {
+        "const": "gitlab",
+        "default": "gitlab",
+        "type": "string"
+      },
+      "endpointUrl": {
+        "description": "GitLab alert integration endpoint URL",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "endpointUrl"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "channelType": {
+        "const": "google_chat",
+        "default": "google_chat",
+        "type": "string"
+      },
+      "webhookUrl": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Google Chat space webhook URL"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "properties": {
+      "apiKey": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "incident.io API key with 'Create incidents' permission"
+      },
+      "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)"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "properties": {
+      "apiToken": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Atlassian API token"
+      },
+      "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",
+      "projectKey"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "apiKey": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Linear API key"
+      },
+      "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": [
+      "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": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Mattermost incoming webhook URL"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "properties": {
+      "apiKey": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "OpsGenie API key for alert creation"
+      },
+      "channelType": {
+        "const": "opsgenie",
+        "default": "opsgenie",
+        "type": "string"
+      },
+      "region": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "OpsGenie API region: us or eu"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "properties": {
+      "channelType": {
+        "const": "pagerduty",
+        "default": "pagerduty",
+        "type": "string"
+      },
+      "routingKey": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "PagerDuty Events API v2 routing (integration) key"
+      },
+      "severityOverride": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Override PagerDuty severity mapping"
+      }
+    },
+    "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; null preserves current"
+      },
+      "phoneNumbers": {
+        "anyOf": [
+          {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Deprecated: use phoneNumber"
+      },
+      "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; null preserves current when phoneNumber also null"
+      },
+      "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": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Pushbullet access token"
+      },
+      "channelType": {
+        "const": "pushbullet",
+        "default": "pushbullet",
+        "type": "string"
+      },
+      "deviceIden": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Target device identifier (broadcasts to all if empty)"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "properties": {
+      "appToken": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Pushover application API token"
+      },
+      "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": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Pushover user or group key"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "properties": {
+      "apiKey": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Rootly API token with incident creation permission"
+      },
+      "channelType": {
+        "const": "rootly",
+        "default": "rootly",
+        "type": "string"
+      },
+      "severity": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Severity slug override (e.g. sev0, sev1)"
+      }
+    },
+    "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": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Slack incoming webhook URL"
+      }
+    },
+    "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; null preserves current"
+      },
+      "phoneNumbers": {
+        "anyOf": [
+          {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Deprecated: use phoneNumber"
+      },
+      "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; null preserves current when phoneNumber also null"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "properties": {
+      "apiKey": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Splunk On-Call REST API key"
+      },
+      "channelType": {
+        "const": "splunk_oncall",
+        "default": "splunk_oncall",
+        "type": "string"
+      },
+      "routingKey": {
+        "description": "Routing key for alert routing",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "routingKey"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "channelType": {
+        "const": "teams",
+        "default": "teams",
+        "type": "string"
+      },
+      "webhookUrl": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Microsoft Teams incoming webhook URL"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "properties": {
+      "botToken": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Telegram bot token from @BotFather"
+      },
+      "channelType": {
+        "const": "telegram",
+        "default": "telegram",
+        "type": "string"
+      },
+      "chatId": {
+        "description": "Chat, group, or channel ID to send alerts to",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "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": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Webhook endpoint URL that receives alert payloads"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "properties": {
+      "channelType": {
+        "const": "zapier",
+        "default": "zapier",
+        "type": "string"
+      },
+      "webhookUrl": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Zapier/n8n/Make catch webhook URL"
+      }
+    },
+    "type": "object"
+  }
+]

addedInput schema / properties / body / properties / enabled

Added value: +{
+  "anyOf": [
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Whether this channel is enabled (default: true); null preserves current value"
+}

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

A3.5/5.0

Behavior2/5

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

With no annotations, the description carries the full burden of disclosing side effects, but it only says 'Update existing' and lists fields. It does not mention full-replacement vs partial-update behavior, what null values do, or any side effects, even though the schema shows 'full replacement, not partial update' for name and null-preserves-current semantics elsewhere.

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

Conciseness5/5

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

Three short sentences, with the core action front-loaded and the pointer to create_alert_channel at the end. Every sentence adds information or a useful reference.

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?

Despite a detailed nested schema and an output schema, the high-level description is too thin for a tool with 20+ config variants and no annotations: it does not clarify that config.channelType selects the channel type, does not mention enabled/managedBy as updatable, and gives no update-semantics guidance. The pointer to create_alert_channel helps, but correct invocation still depends on catching the schema/description mismatch.

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?

Top-level schema coverage is 0%, so the description needs to explain the shape, but its summary is inaccurate: it lists 'type' as a body field even though the body schema has no top-level 'type' property (types are selected via config.channelType), and it omits updatable fields `enabled` and `managedBy`. The nested schema is detailed, but the description's field list is incomplete and misleading.

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 opens with 'Update an existing alert channel,' a specific verb and resource, and 'existing' distinguishes the update operation from sibling create_alert_channel, delete_alert_channel, and test_alert_channel. It also states which fields are updatable, leaving no doubt about the action's scope.

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

Usage Guidelines4/5

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

It clearly frames the tool as modifying an existing channel and points to create_alert_channel for supported channel types, giving an agent a path to the related creation tool. It does not explicitly state 'use create_alert_channel for new channels' or exclude other siblings, so it stops short of full when/when-not guidance.

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

Install Server

Other Tools

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/devhelmhq/mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server