@askqa/mcp 1.0.3 → 1.0.5

package/.claude-plugin/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "askqa",
+  "version": "1.0.0",
+  "description": "AskQA skills — set up notifications and monitoring for your websites"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askqa/mcp",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "MCP server for AskQA — monitor websites with automated tests by chatting with AI",
   "type": "module",
   "license": "MIT",
@@ -21,10 +21,13 @@
   },
   "files": [
     "server.js",
-    "README.md"
+    "README.md",
+    ".claude-plugin",
+    "skills"
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "zod": "^3.23.0"
+    "zod": "^3.23.0",
+    "zod-to-json-schema": "^3.25.0"
   }
 }

package/server.js

@@ -637,17 +637,26 @@ server.registerTool(
 server.registerTool(
   "add_notification_channel",
   {
-    description: "Add a notification channel to receive alerts when scheduled tests fail. Currently supports Telegram. Notifications are sent from @AskQA_Notifications_bot. To get a Telegram chat ID: open https://t.me/userinfobot and press Start — it replies with your ID.",
+    description: "Add a notification channel to receive alerts when scheduled tests fail. Supports email, Telegram, and Slack. For Telegram, get a chat ID from https://t.me/userinfobot. For Slack, create an Incoming Webhook in your Slack workspace settings.",
     inputSchema: {
-      channel_type: z.enum(["telegram"]).describe("The notification channel type"),
-      chat_id: z.string().describe("Telegram chat ID. Get it from https://t.me/userinfobot (open the link, press Start, it replies with your ID)."),
+      channel_type: z.enum(["email", "telegram", "slack"]).describe("The notification channel type"),
+      email_address: z.string().optional().describe("Email address for email channels (required when channel_type is email)"),
+      chat_id: z.string().optional().describe("Telegram chat ID (required when channel_type is telegram). Get it from https://t.me/userinfobot."),
+      webhook_url: z.string().optional().describe("Slack incoming webhook URL (required when channel_type is slack). Create one at https://api.slack.com/messaging/webhooks."),
     },
   },
-  async ({ channel_type, chat_id }) => {
+  async ({ channel_type, email_address, chat_id, webhook_url }) => {
     try {
       const config = {};
       if (channel_type === "telegram") {
+        if (!chat_id) return { content: [{ type: "text", text: "Error: chat_id is required for telegram channels." }], isError: true };
         config.chat_id = chat_id;
+      } else if (channel_type === "email") {
+        if (!email_address) return { content: [{ type: "text", text: "Error: email_address is required for email channels." }], isError: true };
+        config.email_address = email_address;
+      } else if (channel_type === "slack") {
+        if (!webhook_url) return { content: [{ type: "text", text: "Error: webhook_url is required for slack channels." }], isError: true };
+        config.webhook_url = webhook_url;
       }
       const channel = await apiPost("/api/notification-channels", {
         channel_type,
@@ -656,11 +665,17 @@ server.registerTool(
       const lines = [
         `Notification channel created (ID: ${channel.id})`,
         `  Type: ${channel.channel_type}`,
-        `  Chat ID: ${channel.config.chat_id}`,
-        `  Enabled: ${channel.enabled}`,
-        "",
-        "Sending a test notification to verify the channel works...",
-      ].filter(Boolean);
+      ];
+      if (channel_type === "telegram") {
+        lines.push(`  Chat ID: ${channel.config.chat_id}`);
+      } else if (channel_type === "email") {
+        lines.push(`  Email: ${channel.config.email_address}`);
+      } else if (channel_type === "slack") {
+        lines.push(`  Webhook: ${channel.config.webhook_url}`);
+      }
+      lines.push(`  Enabled: ${channel.enabled}`);
+      lines.push("");
+      lines.push("Sending a test notification to verify the channel works...");
 
       // Send test notification
       try {
@@ -694,6 +709,10 @@ server.registerTool(
         lines.push(`ID: ${ch.id} | ${ch.channel_type} (${status})`);
         if (ch.channel_type === "telegram") {
           lines.push(`  Chat ID: ${ch.config.chat_id}`);
+        } else if (ch.channel_type === "email") {
+          lines.push(`  Email: ${ch.config.email_address}`);
+        } else if (ch.channel_type === "slack") {
+          lines.push(`  Webhook: ${ch.config.webhook_url}`);
         }
         lines.push("");
       }

package/skills/setup-slack/SKILL.md

@@ -0,0 +1,40 @@
+# Set Up Slack Notifications
+
+Use this skill to configure Slack notifications for AskQA test failures. When a scheduled test fails, AskQA will post a message to your Slack channel with the test name, failed steps, and a link to the full results.
+
+## Step 1: Create a Slack Incoming Webhook
+
+Slack requires creating a lightweight "app" to generate a webhook URL — it takes under a minute and no coding is involved. Walk the user through these steps:
+
+1. Go to https://api.slack.com/apps
+2. Click **Create New App** > **From scratch**
+3. Name it anything (e.g. "AskQA"), pick your workspace, click **Create App**
+4. In the left sidebar, click **Incoming Webhooks**
+5. Toggle **Activate Incoming Webhooks** to On
+6. Click **Add New Webhook to Workspace** at the bottom
+7. Choose the channel where you want failure alerts (e.g. `#qa-alerts`), click **Allow**
+8. Copy the webhook URL — it looks like `https://hooks.slack.com/services/T.../B.../xxxx`
+
+Ask the user to paste their webhook URL before proceeding.
+
+## Step 2: Add the Notification Channel
+
+Once you have the webhook URL, use the `add_notification_channel` MCP tool:
+
+- `channel_type`: `slack`
+- `webhook_url`: the URL the user provided
+
+This will create the channel and automatically send a test message to verify it works.
+
+## Step 3: Confirm
+
+After the tool succeeds, let the user know:
+
+- A test message was sent to their Slack channel — ask them to check that it arrived
+- From now on, any scheduled test that fails will post an alert to that channel
+- They can manage notification channels with `list_notification_channels` and `remove_notification_channel`
+
+If the test message didn't arrive, suggest they double-check:
+- The webhook URL is correct (starts with `https://hooks.slack.com/`)
+- The Slack app has permission to post to the chosen channel
+- The webhook hasn't been revoked in Slack's app settings