@askqa/mcp 1.0.4 → 1.0.6

package/.claude-plugin/plugin.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askqa/mcp",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "MCP server for AskQA — monitor websites with automated tests by chatting with AI",
   "type": "module",
   "license": "MIT",
@@ -21,7 +21,9 @@
   },
   "files": [
     "server.js",
-    "README.md"
+    "README.md",
+    ".claude-plugin",
+    "skills"
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.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

package/skills/shopify-add-to-cart/SKILL.md

@@ -0,0 +1,55 @@
+# Monitor Shopify Add to Cart
+
+Use this skill to set up automated monitoring for a Shopify store's add-to-cart flow. When the button breaks — due to an app update, theme change, or platform rollout — AskQA catches it within minutes and sends an alert with a screenshot.
+
+## Step 1: Get the store URL
+
+Ask the user for their Shopify store URL (e.g. `https://my-store.myshopify.com` or their custom domain). The test works on any public Shopify storefront — no credentials or API keys are needed.
+
+## Step 2: Create the test
+
+Use the `create_test` MCP tool with these parameters:
+
+- `name`: something descriptive like "Shopify add to cart"
+- `url`: the store URL from Step 1
+- `template_id`: `cart-visible`
+
+This template opens a real browser, finds a product on the homepage, clicks Add to Cart, and verifies the product lands in the cart — exactly how a customer would do it.
+
+## Step 3: Run it once to verify
+
+Use `run_test` with the test ID returned from Step 2. Wait for the result.
+
+If it passes: great, the test is working correctly. Proceed to Step 4.
+
+If it fails: the most common causes on Shopify are:
+- The homepage shows a banner or popup blocking the first product link — let the user know and ask if they want to try a specific product URL instead
+- The store uses an unconventional theme — try passing the product page URL directly as the `url` parameter
+- The add-to-cart button is genuinely broken (that's exactly what this monitor is for!)
+
+## Step 4: Schedule hourly monitoring
+
+Use `schedule_test` with:
+
+- `test_id`: the ID from Step 2
+- `interval`: `hourly`
+
+Hourly is the recommended cadence for checkout monitoring — it catches breakage within 60 minutes, well before most customers notice.
+
+## Step 5: Set up alerts (optional but recommended)
+
+Ask the user how they want to be notified when the test fails. Options:
+
+- **Email**: use `add_notification_channel` with `channel_type: email`
+- **Slack**: use the `/setup-slack` skill first, then link the channel
+- **Skip**: they can always check results manually with `get_test_results`
+
+## Step 6: Confirm
+
+After setup, confirm:
+
+- The test is saved and has a passing run
+- A schedule is active (use `list_schedules` to show them)
+- Alerts are configured if they chose that option
+
+Let the user know: AskQA will now run this test every hour. If add-to-cart ever breaks, they'll get a notification with a screenshot of exactly where it failed.