@visualsentinel/mcp-server 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+All notable changes to `@visualsentinel/mcp-server`. Format follows [Keep a Changelog](https://keepachangelog.com/) and the package uses [Semantic Versioning](https://semver.org/).
+
+## [0.1.0] - 2026-04-29
+
+Initial public release.
+
+### Added
+
+* 16 tools wrapping the public Visual Sentinel REST API (5 public, 11 authenticated).
+* stdio transport (MCP protocol version `2025-06-18`).
+* `VS_API_KEY` (or `VISUALSENTINEL_API_KEY`) for authenticated tools; `VS_API_BASE` override for local development.
+* TypeScript build via tsup, ESM-only, Node 18+.
+* README with installation snippets for Claude Desktop, Claude Code, Cline, Continue.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Visual Sentinel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,174 @@
+# Visual Sentinel MCP Server
+
+Model Context Protocol server for [Visual Sentinel](https://visualsentinel.com), the six-layer website monitoring platform: uptime, performance, SSL, DNS, visual regression, and content change detection.
+
+Connect Claude Desktop, Claude Code, Cline, Continue, or any MCP-compatible client to your Visual Sentinel account so an AI assistant can list monitors, create them, fetch incident history, run free DNS / SSL / speed checks, and acknowledge alerts on your behalf.
+
+* **npm:** `@visualsentinel/mcp-server`
+* **OpenAPI spec:** https://github.com/VisualSentinel/openapi
+* **Get an API key:** https://visualsentinel.com/settings/api-keys
+* **Hosted API reference:** https://visualsentinel.com/docs
+
+## What you get
+
+16 tools spanning the public Visual Sentinel API:
+
+**Public tools (no API key required)**
+
+| Tool | Endpoint | Purpose |
+|---|---|---|
+| `vs_health` | `GET /api/health` | Service health probe |
+| `vs_dns_check` | `GET /api/tools/dns-check` | Resolve A / AAAA / MX / NS / TXT / CNAME / SOA records |
+| `vs_ssl_check` | `GET /api/tools/ssl-check` | Inspect TLS certificate (issuer, validity, SAN list, chain) |
+| `vs_speed_test` | `GET /api/tools/speed-test` | One-shot performance check (TTFB, total load, transfer size) |
+| `vs_website_check` | `GET /api/tools/website-check` | Quick HTTP health check |
+
+**Authenticated tools (require `VS_API_KEY`)**
+
+| Tool | Endpoint | Purpose |
+|---|---|---|
+| `vs_monitors_list` | `GET /api/monitors` | List monitors with optional status / type filters |
+| `vs_monitors_get` | `GET /api/monitors/{id}` | Fetch a single monitor with current status |
+| `vs_monitors_create` | `POST /api/monitors` | Create a new monitor |
+| `vs_monitors_check_now` | `POST /api/monitors/{id}/check` | Trigger an immediate check |
+| `vs_monitors_uptime` | `GET /api/monitors/{id}/uptime` | Uptime percentage over 24h / 7d / 30d / 90d / 365d |
+| `vs_incidents_list` | `GET /api/incidents` | List incidents, filterable by status or monitor |
+| `vs_incidents_get` | `GET /api/incidents/{id}` | Fetch an incident with full check history |
+| `vs_alerts_list` | `GET /api/alerts` | List alerts by status |
+| `vs_alerts_acknowledge` | `POST /api/alerts/{id}/acknowledge` | Acknowledge an alert |
+| `vs_status_pages_list` | `GET /api/status-pages` | List your public status pages |
+| `vs_servers_list` | `GET /api/servers` | List registered origin servers |
+
+## Installation
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "visualsentinel": {
+      "command": "npx",
+      "args": ["-y", "@visualsentinel/mcp-server"],
+      "env": {
+        "VS_API_KEY": "vs_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. The 16 tools appear under the tools menu.
+
+### Claude Code (CLI)
+
+```bash
+claude mcp add visualsentinel \
+  -- npx -y @visualsentinel/mcp-server
+```
+
+Then export `VS_API_KEY` in the shell where Claude Code runs.
+
+### Cline (VS Code extension)
+
+In Cline's MCP settings, add:
+
+```json
+{
+  "visualsentinel": {
+    "command": "npx",
+    "args": ["-y", "@visualsentinel/mcp-server"],
+    "env": { "VS_API_KEY": "vs_live_..." }
+  }
+}
+```
+
+### Continue
+
+In `~/.continue/config.json`:
+
+```json
+{
+  "mcpServers": [
+    {
+      "name": "visualsentinel",
+      "command": "npx",
+      "args": ["-y", "@visualsentinel/mcp-server"],
+      "env": { "VS_API_KEY": "vs_live_..." }
+    }
+  ]
+}
+```
+
+### Generic MCP client (stdio)
+
+```bash
+VS_API_KEY=vs_live_xxx npx -y @visualsentinel/mcp-server
+```
+
+The server speaks JSON-RPC over stdio per the MCP specification (`2025-06-18`).
+
+## Configuration
+
+Two environment variables, both optional except in the noted cases:
+
+| Variable | Default | Purpose |
+|---|---|---|
+| `VS_API_KEY` | (none) | Required for the 11 authenticated tools. Public tools work without it. Generate at https://visualsentinel.com/settings/api-keys. |
+| `VS_API_BASE` | `https://visualsentinel.com` | Override only for testing against a local development instance. |
+
+If a tool that needs auth is called without `VS_API_KEY`, the server returns a clear error rather than silently failing.
+
+`VISUALSENTINEL_API_KEY` is accepted as an alias for `VS_API_KEY` for clients that prefer the longer name.
+
+## Usage examples
+
+After installation, ask the AI assistant things like:
+
+* "What's the SSL certificate situation on visualsentinel.com? When does it expire?"
+* "List my Visual Sentinel monitors that are currently down."
+* "Add a new HTTPS monitor for https://shop.example.com checking every minute."
+* "Show me incidents from the last 24 hours and acknowledge the ones for monitor-id `clm123`."
+* "What's the uptime percentage for my landing page over the last 30 days?"
+* "Run a speed test on https://example.com/checkout."
+
+The assistant chooses the appropriate tool, fills in arguments from the conversation, and shows the JSON response.
+
+## Security notes
+
+* Your API key never leaves the machine running this MCP server. Requests go directly to `https://visualsentinel.com` over HTTPS.
+* Public tools (`vs_health`, `vs_dns_check`, `vs_ssl_check`, `vs_speed_test`, `vs_website_check`) work without an API key, but their results are visible to anyone who can read your conversation logs. Treat them like any other shell-out.
+* Revoke a leaked API key immediately at https://visualsentinel.com/settings/api-keys. Revocation takes effect within seconds.
+* Tools that mutate state (`vs_monitors_create`, `vs_monitors_check_now`, `vs_alerts_acknowledge`) inherit your API key's role-based permissions. A read-only key cannot create monitors.
+
+## Development
+
+```bash
+git clone https://github.com/VisualSentinel/mcp-server.git
+cd mcp-server
+npm install
+npm run build      # tsup, output to dist/
+npm run lint       # tsc --noEmit
+npm run dev        # tsup --watch
+```
+
+To smoke-test locally against the production API:
+
+```bash
+VS_API_KEY=vs_live_... node dist/index.js
+```
+
+The server speaks JSON-RPC on stdin / stdout. Pipe in a `tools/list` request to see the registered tools.
+
+## Versioning
+
+Semantic versioning. Breaking changes to tool names or required arguments get a major bump. Adding new tools or new optional arguments is a minor or patch.
+
+The server's tool surface tracks the public Visual Sentinel API spec at https://github.com/VisualSentinel/openapi. When the upstream API gains a useful endpoint, this repository typically catches up within a release.
+
+## License
+
+MIT. See [`LICENSE`](./LICENSE).
+
+The Visual Sentinel API service itself is governed by https://visualsentinel.com/terms.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1,463 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+
+// src/api-client.ts
+var DEFAULT_BASE = "https://visualsentinel.com";
+var VsApiError = class extends Error {
+  constructor(message, status, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+    this.name = "VsApiError";
+  }
+  status;
+  body;
+};
+var ApiClient = class {
+  apiKey;
+  baseUrl;
+  userAgent;
+  constructor(opts = {}) {
+    this.apiKey = opts.apiKey ?? process.env.VS_API_KEY ?? process.env.VISUALSENTINEL_API_KEY ?? void 0;
+    this.baseUrl = (opts.baseUrl ?? process.env.VS_API_BASE ?? DEFAULT_BASE).replace(
+      /\/+$/,
+      ""
+    );
+    this.userAgent = opts.userAgent ?? "@visualsentinel/mcp-server";
+  }
+  hasApiKey() {
+    return typeof this.apiKey === "string" && this.apiKey.length > 0;
+  }
+  async request(method, path, options = {}) {
+    const auth = options.auth ?? true;
+    if (auth && !this.hasApiKey()) {
+      throw new VsApiError(
+        "Visual Sentinel API key required. Set VS_API_KEY (https://visualsentinel.com/settings/api-keys).",
+        401,
+        null
+      );
+    }
+    const url = new URL(path.startsWith("/") ? path : `/${path}`, this.baseUrl);
+    if (options.query) {
+      for (const [k, v] of Object.entries(options.query)) {
+        if (v !== void 0 && v !== null) url.searchParams.set(k, String(v));
+      }
+    }
+    const headers = {
+      Accept: "application/json",
+      "User-Agent": this.userAgent
+    };
+    if (auth && this.apiKey) headers["X-API-Key"] = this.apiKey;
+    if (options.body !== void 0) headers["Content-Type"] = "application/json";
+    const res = await fetch(url, {
+      method,
+      headers,
+      body: options.body !== void 0 ? JSON.stringify(options.body) : void 0
+    });
+    const text = await res.text();
+    let parsed = null;
+    if (text.length > 0) {
+      try {
+        parsed = JSON.parse(text);
+      } catch {
+        parsed = text;
+      }
+    }
+    if (!res.ok) {
+      throw new VsApiError(
+        `Visual Sentinel API ${method} ${path} returned ${res.status}`,
+        res.status,
+        parsed
+      );
+    }
+    return parsed;
+  }
+};
+
+// src/tools.ts
+var STR = { type: "string" };
+var INT = { type: "integer" };
+function pickString(args, key) {
+  const v = args[key];
+  return typeof v === "string" && v.length > 0 ? v : void 0;
+}
+function pickNumber(args, key) {
+  const v = args[key];
+  return typeof v === "number" && Number.isFinite(v) ? v : void 0;
+}
+function requireString(args, key) {
+  const v = pickString(args, key);
+  if (!v) throw new Error(`Argument "${key}" (string) is required.`);
+  return v;
+}
+var TOOLS = [
+  // -------------------------------------------------------------------------
+  // Public tools (no auth)
+  // -------------------------------------------------------------------------
+  {
+    name: "vs_health",
+    description: "Check whether Visual Sentinel itself is up. Returns the service health status. No authentication required.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    },
+    requiresAuth: false,
+    handler: async (_args, client) => client.request("GET", "/api/health", { auth: false })
+  },
+  {
+    name: "vs_dns_check",
+    description: "Resolve DNS records (A, AAAA, MX, NS, TXT, CNAME) for a domain using Visual Sentinel's public DNS lookup tool. No authentication required.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        domain: { ...STR, description: "Domain to resolve, e.g. example.com (without protocol)." },
+        recordType: {
+          ...STR,
+          description: "Optional: limit to one record type. One of: A, AAAA, MX, NS, TXT, CNAME, SOA. Default: all."
+        }
+      },
+      required: ["domain"],
+      additionalProperties: false
+    },
+    requiresAuth: false,
+    handler: async (args, client) => client.request("GET", "/api/tools/dns-check", {
+      auth: false,
+      query: {
+        domain: requireString(args, "domain"),
+        recordType: pickString(args, "recordType")
+      }
+    })
+  },
+  {
+    name: "vs_ssl_check",
+    description: "Inspect a TLS/SSL certificate for a hostname: issuer, subject, validity dates, SAN list, key algorithm, and certificate chain. No authentication required.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        host: { ...STR, description: "Hostname to inspect, e.g. example.com (without protocol)." },
+        port: { ...INT, description: "TCP port. Default 443." }
+      },
+      required: ["host"],
+      additionalProperties: false
+    },
+    requiresAuth: false,
+    handler: async (args, client) => client.request("GET", "/api/tools/ssl-check", {
+      auth: false,
+      query: { host: requireString(args, "host"), port: pickNumber(args, "port") }
+    })
+  },
+  {
+    name: "vs_speed_test",
+    description: "Run a one-shot performance check against a URL: TTFB, total load time, transfer size, status code, and redirect chain. No authentication required.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: { ...STR, description: "Full URL to test, including protocol (https://...)." }
+      },
+      required: ["url"],
+      additionalProperties: false
+    },
+    requiresAuth: false,
+    handler: async (args, client) => client.request("GET", "/api/tools/speed-test", {
+      auth: false,
+      query: { url: requireString(args, "url") }
+    })
+  },
+  {
+    name: "vs_website_check",
+    description: "Quick health check for a URL: HTTP status, response time, server header, content snippet, and basic SSL state. No authentication required.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: { ...STR, description: "Full URL to test, including protocol (https://...)." }
+      },
+      required: ["url"],
+      additionalProperties: false
+    },
+    requiresAuth: false,
+    handler: async (args, client) => client.request("GET", "/api/tools/website-check", {
+      auth: false,
+      query: { url: requireString(args, "url") }
+    })
+  },
+  // -------------------------------------------------------------------------
+  // Authenticated tools (require VS_API_KEY)
+  // -------------------------------------------------------------------------
+  {
+    name: "vs_monitors_list",
+    description: "List monitors in the authenticated organization. Optional filters narrow by status, type, or paginate.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        status: { ...STR, description: "Filter: UP, DOWN, PAUSED, MAINTENANCE." },
+        type: {
+          ...STR,
+          description: "Filter by monitor type: HTTP, HTTPS, KEYWORD, PING, PORT, DNS, SSL, VISUAL, CONTENT, API, GRAPHQL, WEBSOCKET."
+        },
+        page: { ...INT, description: "Page number (default 1)." },
+        limit: { ...INT, description: "Items per page (default 50, max 200)." }
+      },
+      additionalProperties: false
+    },
+    requiresAuth: true,
+    handler: async (args, client) => client.request("GET", "/api/monitors", {
+      query: {
+        status: pickString(args, "status"),
+        type: pickString(args, "type"),
+        page: pickNumber(args, "page"),
+        limit: pickNumber(args, "limit")
+      }
+    })
+  },
+  {
+    name: "vs_monitors_get",
+    description: "Fetch a single monitor by id, including its current status, last check, and configuration.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { ...STR, description: "Monitor id (cuid)." }
+      },
+      required: ["id"],
+      additionalProperties: false
+    },
+    requiresAuth: true,
+    handler: async (args, client) => client.request("GET", `/api/monitors/${encodeURIComponent(requireString(args, "id"))}`)
+  },
+  {
+    name: "vs_monitors_create",
+    description: "Create a new monitor. Provide at least name, url, and type. Returns the created monitor including its assigned id.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: { ...STR, description: "Display name for the monitor." },
+        url: { ...STR, description: "Full URL to monitor (or hostname for PING/PORT/DNS/SSL)." },
+        type: {
+          ...STR,
+          description: "Monitor type: HTTP, HTTPS, KEYWORD, PING, PORT, DNS, SSL, VISUAL, CONTENT, API, GRAPHQL, WEBSOCKET."
+        },
+        interval: { ...INT, description: "Check interval in seconds (60, 300, 600, 1800, 3600)." },
+        timeout: { ...INT, description: "Per-check timeout in seconds (default 30)." },
+        method: { ...STR, description: "HTTP method for HTTP/HTTPS monitors (default GET)." },
+        keyword: { ...STR, description: "Keyword to assert for KEYWORD monitors." },
+        port: { ...INT, description: "TCP port for PORT monitors." }
+      },
+      required: ["name", "url", "type"],
+      additionalProperties: false
+    },
+    requiresAuth: true,
+    handler: async (args, client) => client.request("POST", "/api/monitors", {
+      body: {
+        name: requireString(args, "name"),
+        url: requireString(args, "url"),
+        type: requireString(args, "type"),
+        interval: pickNumber(args, "interval"),
+        timeout: pickNumber(args, "timeout"),
+        method: pickString(args, "method"),
+        keyword: pickString(args, "keyword"),
+        port: pickNumber(args, "port")
+      }
+    })
+  },
+  {
+    name: "vs_monitors_check_now",
+    description: "Trigger an immediate check for a monitor (in addition to its scheduled cadence). Returns the freshly-collected check result.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { ...STR, description: "Monitor id." }
+      },
+      required: ["id"],
+      additionalProperties: false
+    },
+    requiresAuth: true,
+    handler: async (args, client) => client.request("POST", `/api/monitors/${encodeURIComponent(requireString(args, "id"))}/check`)
+  },
+  {
+    name: "vs_monitors_uptime",
+    description: "Fetch the uptime percentage and outage breakdown for a monitor over a window (default last 30 days).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { ...STR, description: "Monitor id." },
+        window: {
+          ...STR,
+          description: "Window: 24h, 7d, 30d, 90d, 365d. Default 30d."
+        }
+      },
+      required: ["id"],
+      additionalProperties: false
+    },
+    requiresAuth: true,
+    handler: async (args, client) => client.request("GET", `/api/monitors/${encodeURIComponent(requireString(args, "id"))}/uptime`, {
+      query: { window: pickString(args, "window") }
+    })
+  },
+  {
+    name: "vs_incidents_list",
+    description: "List incidents for the authenticated organization. Filter by status (OPEN/RESOLVED), monitor id, or paginate.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        status: { ...STR, description: "OPEN or RESOLVED." },
+        monitorId: { ...STR, description: "Filter to one monitor." },
+        page: { ...INT },
+        limit: { ...INT, description: "Default 50, max 200." }
+      },
+      additionalProperties: false
+    },
+    requiresAuth: true,
+    handler: async (args, client) => client.request("GET", "/api/incidents", {
+      query: {
+        status: pickString(args, "status"),
+        monitorId: pickString(args, "monitorId"),
+        page: pickNumber(args, "page"),
+        limit: pickNumber(args, "limit")
+      }
+    })
+  },
+  {
+    name: "vs_incidents_get",
+    description: "Fetch a single incident with its full check history and root-cause hints.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { ...STR, description: "Incident id." }
+      },
+      required: ["id"],
+      additionalProperties: false
+    },
+    requiresAuth: true,
+    handler: async (args, client) => client.request("GET", `/api/incidents/${encodeURIComponent(requireString(args, "id"))}`)
+  },
+  {
+    name: "vs_alerts_list",
+    description: "List alerts for the authenticated organization. Filter by status (UNACKNOWLEDGED/ACKNOWLEDGED/RESOLVED) or paginate.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        status: { ...STR, description: "UNACKNOWLEDGED, ACKNOWLEDGED, or RESOLVED." },
+        page: { ...INT },
+        limit: { ...INT, description: "Default 50, max 200." }
+      },
+      additionalProperties: false
+    },
+    requiresAuth: true,
+    handler: async (args, client) => client.request("GET", "/api/alerts", {
+      query: {
+        status: pickString(args, "status"),
+        page: pickNumber(args, "page"),
+        limit: pickNumber(args, "limit")
+      }
+    })
+  },
+  {
+    name: "vs_alerts_acknowledge",
+    description: "Acknowledge an alert by id. Acknowledgement is recorded with the calling API key's user.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { ...STR, description: "Alert id." },
+        note: { ...STR, description: "Optional acknowledgement note (visible in alert history)." }
+      },
+      required: ["id"],
+      additionalProperties: false
+    },
+    requiresAuth: true,
+    handler: async (args, client) => client.request("POST", `/api/alerts/${encodeURIComponent(requireString(args, "id"))}/acknowledge`, {
+      body: { note: pickString(args, "note") }
+    })
+  },
+  {
+    name: "vs_status_pages_list",
+    description: "List public-facing status pages owned by the authenticated organization.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    },
+    requiresAuth: true,
+    handler: async (_args, client) => client.request("GET", "/api/status-pages")
+  },
+  {
+    name: "vs_servers_list",
+    description: "List servers (origins) registered in the authenticated organization.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        page: { ...INT },
+        limit: { ...INT, description: "Default 50." }
+      },
+      additionalProperties: false
+    },
+    requiresAuth: true,
+    handler: async (args, client) => client.request("GET", "/api/servers", {
+      query: { page: pickNumber(args, "page"), limit: pickNumber(args, "limit") }
+    })
+  }
+];
+function findTool(name) {
+  return TOOLS.find((t) => t.name === name);
+}
+
+// src/index.ts
+var SERVER_NAME = "visualsentinel";
+var SERVER_VERSION = "0.1.0";
+function toMcpToolDescriptor(tool) {
+  return {
+    name: tool.name,
+    description: tool.description,
+    inputSchema: tool.inputSchema
+  };
+}
+async function main() {
+  const client = new ApiClient();
+  const server = new Server(
+    { name: SERVER_NAME, version: SERVER_VERSION },
+    { capabilities: { tools: {} } }
+  );
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: TOOLS.map(toMcpToolDescriptor)
+  }));
+  server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const tool = findTool(req.params.name);
+    if (!tool) {
+      return {
+        isError: true,
+        content: [{ type: "text", text: `Unknown tool: ${req.params.name}` }]
+      };
+    }
+    try {
+      const result = await tool.handler(req.params.arguments ?? {}, client);
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
+      };
+    } catch (err) {
+      const message = err instanceof VsApiError ? `Visual Sentinel API error (${err.status}): ${err.message}
+${typeof err.body === "string" ? err.body : JSON.stringify(err.body, null, 2)}` : err instanceof Error ? err.message : String(err);
+      return {
+        isError: true,
+        content: [{ type: "text", text: message }]
+      };
+    }
+  });
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+main().catch((err) => {
+  console.error("[visualsentinel-mcp-server] fatal:", err);
+  process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/api-client.ts","../src/tools.ts"],"sourcesContent":["/**\n * Visual Sentinel MCP server (stdio transport).\n *\n * Run via:\n *   VS_API_KEY=vs_live_... npx @visualsentinel/mcp-server\n *\n * The server registers all tools defined in `./tools.ts` with the MCP SDK\n * and answers tools/list and tools/call requests. Public tools (health,\n * DNS check, SSL check, speed test, website check) work without an API key;\n * everything else returns a clear error if VS_API_KEY is not set.\n */\n\nimport { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport {\n  CallToolRequestSchema,\n  ListToolsRequestSchema,\n} from '@modelcontextprotocol/sdk/types.js';\n\nimport { ApiClient, VsApiError } from './api-client.js';\nimport { TOOLS, findTool } from './tools.js';\n\nconst SERVER_NAME = 'visualsentinel';\nconst SERVER_VERSION = '0.1.0';\n\nfunction toMcpToolDescriptor(tool: (typeof TOOLS)[number]) {\n  return {\n    name: tool.name,\n    description: tool.description,\n    inputSchema: tool.inputSchema,\n  };\n}\n\nasync function main(): Promise<void> {\n  const client = new ApiClient();\n  const server = new Server(\n    { name: SERVER_NAME, version: SERVER_VERSION },\n    { capabilities: { tools: {} } },\n  );\n\n  server.setRequestHandler(ListToolsRequestSchema, async () => ({\n    tools: TOOLS.map(toMcpToolDescriptor),\n  }));\n\n  server.setRequestHandler(CallToolRequestSchema, async (req) => {\n    const tool = findTool(req.params.name);\n    if (!tool) {\n      return {\n        isError: true,\n        content: [{ type: 'text', text: `Unknown tool: ${req.params.name}` }],\n      };\n    }\n\n    try {\n      const result = await tool.handler(req.params.arguments ?? {}, client);\n      return {\n        content: [\n          {\n            type: 'text',\n            text: JSON.stringify(result, null, 2),\n          },\n        ],\n      };\n    } catch (err) {\n      const message = err instanceof VsApiError\n        ? `Visual Sentinel API error (${err.status}): ${err.message}\\n${\n            typeof err.body === 'string' ? err.body : JSON.stringify(err.body, null, 2)\n          }`\n        : err instanceof Error\n          ? err.message\n          : String(err);\n      return {\n        isError: true,\n        content: [{ type: 'text', text: message }],\n      };\n    }\n  });\n\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n}\n\nmain().catch((err) => {\n  // eslint-disable-next-line no-console\n  console.error('[visualsentinel-mcp-server] fatal:', err);\n  process.exit(1);\n});\n","/**\n * Tiny HTTP client for the Visual Sentinel public API.\n *\n * Reads the API key from `VS_API_KEY` (or `VISUALSENTINEL_API_KEY`) once at\n * construction time. All requests are routed at `https://visualsentinel.com`\n * unless `VS_API_BASE` overrides it (useful for testing against a local\n * dev instance).\n */\n\nconst DEFAULT_BASE = 'https://visualsentinel.com';\n\nexport interface ApiClientOptions {\n  apiKey?: string | undefined;\n  baseUrl?: string | undefined;\n  userAgent?: string;\n}\n\nexport class VsApiError extends Error {\n  constructor(\n    message: string,\n    public readonly status: number,\n    public readonly body: unknown,\n  ) {\n    super(message);\n    this.name = 'VsApiError';\n  }\n}\n\nexport class ApiClient {\n  private readonly apiKey: string | undefined;\n  private readonly baseUrl: string;\n  private readonly userAgent: string;\n\n  constructor(opts: ApiClientOptions = {}) {\n    this.apiKey =\n      opts.apiKey ??\n      process.env.VS_API_KEY ??\n      process.env.VISUALSENTINEL_API_KEY ??\n      undefined;\n    this.baseUrl = (opts.baseUrl ?? process.env.VS_API_BASE ?? DEFAULT_BASE).replace(\n      /\\/+$/,\n      '',\n    );\n    this.userAgent = opts.userAgent ?? '@visualsentinel/mcp-server';\n  }\n\n  hasApiKey(): boolean {\n    return typeof this.apiKey === 'string' && this.apiKey.length > 0;\n  }\n\n  async request<T = unknown>(\n    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE',\n    path: string,\n    options: { query?: Record<string, string | number | boolean | undefined>; body?: unknown; auth?: boolean } = {},\n  ): Promise<T> {\n    const auth = options.auth ?? true;\n    if (auth && !this.hasApiKey()) {\n      throw new VsApiError(\n        'Visual Sentinel API key required. Set VS_API_KEY (https://visualsentinel.com/settings/api-keys).',\n        401,\n        null,\n      );\n    }\n\n    const url = new URL(path.startsWith('/') ? path : `/${path}`, this.baseUrl);\n    if (options.query) {\n      for (const [k, v] of Object.entries(options.query)) {\n        if (v !== undefined && v !== null) url.searchParams.set(k, String(v));\n      }\n    }\n\n    const headers: Record<string, string> = {\n      Accept: 'application/json',\n      'User-Agent': this.userAgent,\n    };\n    if (auth && this.apiKey) headers['X-API-Key'] = this.apiKey;\n    if (options.body !== undefined) headers['Content-Type'] = 'application/json';\n\n    const res = await fetch(url, {\n      method,\n      headers,\n      body: options.body !== undefined ? JSON.stringify(options.body) : undefined,\n    });\n\n    const text = await res.text();\n    let parsed: unknown = null;\n    if (text.length > 0) {\n      try {\n        parsed = JSON.parse(text);\n      } catch {\n        parsed = text;\n      }\n    }\n\n    if (!res.ok) {\n      throw new VsApiError(\n        `Visual Sentinel API ${method} ${path} returned ${res.status}`,\n        res.status,\n        parsed,\n      );\n    }\n\n    return parsed as T;\n  }\n}\n","/**\n * Tool registry for the Visual Sentinel MCP server.\n *\n * Each tool wraps a single Visual Sentinel REST endpoint with a JSON Schema\n * input and a structured handler. Public-tool handlers (DNS check, SSL check,\n * speed test, website check, health) run without authentication; everything\n * else requires `VS_API_KEY`.\n */\n\nimport { ApiClient } from './api-client.js';\n\ninterface ToolInput {\n  type: 'object';\n  properties: Record<string, unknown>;\n  required?: string[];\n  additionalProperties?: boolean;\n}\n\nexport interface ToolDefinition {\n  name: string;\n  description: string;\n  inputSchema: ToolInput;\n  requiresAuth: boolean;\n  handler: (args: Record<string, unknown>, client: ApiClient) => Promise<unknown>;\n}\n\nconst STR = { type: 'string' as const };\nconst NUM = { type: 'number' as const };\nconst INT = { type: 'integer' as const };\nconst BOOL = { type: 'boolean' as const };\n\nfunction pickString(args: Record<string, unknown>, key: string): string | undefined {\n  const v = args[key];\n  return typeof v === 'string' && v.length > 0 ? v : undefined;\n}\n\nfunction pickNumber(args: Record<string, unknown>, key: string): number | undefined {\n  const v = args[key];\n  return typeof v === 'number' && Number.isFinite(v) ? v : undefined;\n}\n\nfunction requireString(args: Record<string, unknown>, key: string): string {\n  const v = pickString(args, key);\n  if (!v) throw new Error(`Argument \"${key}\" (string) is required.`);\n  return v;\n}\n\nexport const TOOLS: ToolDefinition[] = [\n  // -------------------------------------------------------------------------\n  // Public tools (no auth)\n  // -------------------------------------------------------------------------\n  {\n    name: 'vs_health',\n    description:\n      'Check whether Visual Sentinel itself is up. Returns the service health status. No authentication required.',\n    inputSchema: {\n      type: 'object',\n      properties: {},\n      additionalProperties: false,\n    },\n    requiresAuth: false,\n    handler: async (_args, client) => client.request('GET', '/api/health', { auth: false }),\n  },\n\n  {\n    name: 'vs_dns_check',\n    description:\n      'Resolve DNS records (A, AAAA, MX, NS, TXT, CNAME) for a domain using Visual Sentinel\\'s public DNS lookup tool. No authentication required.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        domain: { ...STR, description: 'Domain to resolve, e.g. example.com (without protocol).' },\n        recordType: {\n          ...STR,\n          description: 'Optional: limit to one record type. One of: A, AAAA, MX, NS, TXT, CNAME, SOA. Default: all.',\n        },\n      },\n      required: ['domain'],\n      additionalProperties: false,\n    },\n    requiresAuth: false,\n    handler: async (args, client) =>\n      client.request('GET', '/api/tools/dns-check', {\n        auth: false,\n        query: {\n          domain: requireString(args, 'domain'),\n          recordType: pickString(args, 'recordType'),\n        },\n      }),\n  },\n\n  {\n    name: 'vs_ssl_check',\n    description:\n      'Inspect a TLS/SSL certificate for a hostname: issuer, subject, validity dates, SAN list, key algorithm, and certificate chain. No authentication required.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        host: { ...STR, description: 'Hostname to inspect, e.g. example.com (without protocol).' },\n        port: { ...INT, description: 'TCP port. Default 443.' },\n      },\n      required: ['host'],\n      additionalProperties: false,\n    },\n    requiresAuth: false,\n    handler: async (args, client) =>\n      client.request('GET', '/api/tools/ssl-check', {\n        auth: false,\n        query: { host: requireString(args, 'host'), port: pickNumber(args, 'port') },\n      }),\n  },\n\n  {\n    name: 'vs_speed_test',\n    description:\n      'Run a one-shot performance check against a URL: TTFB, total load time, transfer size, status code, and redirect chain. No authentication required.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        url: { ...STR, description: 'Full URL to test, including protocol (https://...).' },\n      },\n      required: ['url'],\n      additionalProperties: false,\n    },\n    requiresAuth: false,\n    handler: async (args, client) =>\n      client.request('GET', '/api/tools/speed-test', {\n        auth: false,\n        query: { url: requireString(args, 'url') },\n      }),\n  },\n\n  {\n    name: 'vs_website_check',\n    description:\n      'Quick health check for a URL: HTTP status, response time, server header, content snippet, and basic SSL state. No authentication required.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        url: { ...STR, description: 'Full URL to test, including protocol (https://...).' },\n      },\n      required: ['url'],\n      additionalProperties: false,\n    },\n    requiresAuth: false,\n    handler: async (args, client) =>\n      client.request('GET', '/api/tools/website-check', {\n        auth: false,\n        query: { url: requireString(args, 'url') },\n      }),\n  },\n\n  // -------------------------------------------------------------------------\n  // Authenticated tools (require VS_API_KEY)\n  // -------------------------------------------------------------------------\n  {\n    name: 'vs_monitors_list',\n    description:\n      'List monitors in the authenticated organization. Optional filters narrow by status, type, or paginate.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        status: { ...STR, description: 'Filter: UP, DOWN, PAUSED, MAINTENANCE.' },\n        type: {\n          ...STR,\n          description:\n            'Filter by monitor type: HTTP, HTTPS, KEYWORD, PING, PORT, DNS, SSL, VISUAL, CONTENT, API, GRAPHQL, WEBSOCKET.',\n        },\n        page: { ...INT, description: 'Page number (default 1).' },\n        limit: { ...INT, description: 'Items per page (default 50, max 200).' },\n      },\n      additionalProperties: false,\n    },\n    requiresAuth: true,\n    handler: async (args, client) =>\n      client.request('GET', '/api/monitors', {\n        query: {\n          status: pickString(args, 'status'),\n          type: pickString(args, 'type'),\n          page: pickNumber(args, 'page'),\n          limit: pickNumber(args, 'limit'),\n        },\n      }),\n  },\n\n  {\n    name: 'vs_monitors_get',\n    description:\n      'Fetch a single monitor by id, including its current status, last check, and configuration.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        id: { ...STR, description: 'Monitor id (cuid).' },\n      },\n      required: ['id'],\n      additionalProperties: false,\n    },\n    requiresAuth: true,\n    handler: async (args, client) =>\n      client.request('GET', `/api/monitors/${encodeURIComponent(requireString(args, 'id'))}`),\n  },\n\n  {\n    name: 'vs_monitors_create',\n    description:\n      'Create a new monitor. Provide at least name, url, and type. Returns the created monitor including its assigned id.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        name: { ...STR, description: 'Display name for the monitor.' },\n        url: { ...STR, description: 'Full URL to monitor (or hostname for PING/PORT/DNS/SSL).' },\n        type: {\n          ...STR,\n          description:\n            'Monitor type: HTTP, HTTPS, KEYWORD, PING, PORT, DNS, SSL, VISUAL, CONTENT, API, GRAPHQL, WEBSOCKET.',\n        },\n        interval: { ...INT, description: 'Check interval in seconds (60, 300, 600, 1800, 3600).' },\n        timeout: { ...INT, description: 'Per-check timeout in seconds (default 30).' },\n        method: { ...STR, description: 'HTTP method for HTTP/HTTPS monitors (default GET).' },\n        keyword: { ...STR, description: 'Keyword to assert for KEYWORD monitors.' },\n        port: { ...INT, description: 'TCP port for PORT monitors.' },\n      },\n      required: ['name', 'url', 'type'],\n      additionalProperties: false,\n    },\n    requiresAuth: true,\n    handler: async (args, client) =>\n      client.request('POST', '/api/monitors', {\n        body: {\n          name: requireString(args, 'name'),\n          url: requireString(args, 'url'),\n          type: requireString(args, 'type'),\n          interval: pickNumber(args, 'interval'),\n          timeout: pickNumber(args, 'timeout'),\n          method: pickString(args, 'method'),\n          keyword: pickString(args, 'keyword'),\n          port: pickNumber(args, 'port'),\n        },\n      }),\n  },\n\n  {\n    name: 'vs_monitors_check_now',\n    description:\n      'Trigger an immediate check for a monitor (in addition to its scheduled cadence). Returns the freshly-collected check result.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        id: { ...STR, description: 'Monitor id.' },\n      },\n      required: ['id'],\n      additionalProperties: false,\n    },\n    requiresAuth: true,\n    handler: async (args, client) =>\n      client.request('POST', `/api/monitors/${encodeURIComponent(requireString(args, 'id'))}/check`),\n  },\n\n  {\n    name: 'vs_monitors_uptime',\n    description:\n      'Fetch the uptime percentage and outage breakdown for a monitor over a window (default last 30 days).',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        id: { ...STR, description: 'Monitor id.' },\n        window: {\n          ...STR,\n          description: 'Window: 24h, 7d, 30d, 90d, 365d. Default 30d.',\n        },\n      },\n      required: ['id'],\n      additionalProperties: false,\n    },\n    requiresAuth: true,\n    handler: async (args, client) =>\n      client.request('GET', `/api/monitors/${encodeURIComponent(requireString(args, 'id'))}/uptime`, {\n        query: { window: pickString(args, 'window') },\n      }),\n  },\n\n  {\n    name: 'vs_incidents_list',\n    description:\n      'List incidents for the authenticated organization. Filter by status (OPEN/RESOLVED), monitor id, or paginate.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        status: { ...STR, description: 'OPEN or RESOLVED.' },\n        monitorId: { ...STR, description: 'Filter to one monitor.' },\n        page: { ...INT },\n        limit: { ...INT, description: 'Default 50, max 200.' },\n      },\n      additionalProperties: false,\n    },\n    requiresAuth: true,\n    handler: async (args, client) =>\n      client.request('GET', '/api/incidents', {\n        query: {\n          status: pickString(args, 'status'),\n          monitorId: pickString(args, 'monitorId'),\n          page: pickNumber(args, 'page'),\n          limit: pickNumber(args, 'limit'),\n        },\n      }),\n  },\n\n  {\n    name: 'vs_incidents_get',\n    description: 'Fetch a single incident with its full check history and root-cause hints.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        id: { ...STR, description: 'Incident id.' },\n      },\n      required: ['id'],\n      additionalProperties: false,\n    },\n    requiresAuth: true,\n    handler: async (args, client) =>\n      client.request('GET', `/api/incidents/${encodeURIComponent(requireString(args, 'id'))}`),\n  },\n\n  {\n    name: 'vs_alerts_list',\n    description:\n      'List alerts for the authenticated organization. Filter by status (UNACKNOWLEDGED/ACKNOWLEDGED/RESOLVED) or paginate.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        status: { ...STR, description: 'UNACKNOWLEDGED, ACKNOWLEDGED, or RESOLVED.' },\n        page: { ...INT },\n        limit: { ...INT, description: 'Default 50, max 200.' },\n      },\n      additionalProperties: false,\n    },\n    requiresAuth: true,\n    handler: async (args, client) =>\n      client.request('GET', '/api/alerts', {\n        query: {\n          status: pickString(args, 'status'),\n          page: pickNumber(args, 'page'),\n          limit: pickNumber(args, 'limit'),\n        },\n      }),\n  },\n\n  {\n    name: 'vs_alerts_acknowledge',\n    description: 'Acknowledge an alert by id. Acknowledgement is recorded with the calling API key\\'s user.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        id: { ...STR, description: 'Alert id.' },\n        note: { ...STR, description: 'Optional acknowledgement note (visible in alert history).' },\n      },\n      required: ['id'],\n      additionalProperties: false,\n    },\n    requiresAuth: true,\n    handler: async (args, client) =>\n      client.request('POST', `/api/alerts/${encodeURIComponent(requireString(args, 'id'))}/acknowledge`, {\n        body: { note: pickString(args, 'note') },\n      }),\n  },\n\n  {\n    name: 'vs_status_pages_list',\n    description: 'List public-facing status pages owned by the authenticated organization.',\n    inputSchema: {\n      type: 'object',\n      properties: {},\n      additionalProperties: false,\n    },\n    requiresAuth: true,\n    handler: async (_args, client) => client.request('GET', '/api/status-pages'),\n  },\n\n  {\n    name: 'vs_servers_list',\n    description: 'List servers (origins) registered in the authenticated organization.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        page: { ...INT },\n        limit: { ...INT, description: 'Default 50.' },\n      },\n      additionalProperties: false,\n    },\n    requiresAuth: true,\n    handler: async (args, client) =>\n      client.request('GET', '/api/servers', {\n        query: { page: pickNumber(args, 'page'), limit: pickNumber(args, 'limit') },\n      }),\n  },\n];\n\nexport function findTool(name: string): ToolDefinition | undefined {\n  return TOOLS.find((t) => t.name === name);\n}\n\n// Suppress unused-warning suppression: BOOL/NUM are reserved for future tools.\nvoid BOOL;\nvoid NUM;\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@visualsentinel/mcp-server",
+  "version": "0.1.0",
+  "description": "Model Context Protocol server for Visual Sentinel: six-layer website monitoring (uptime, performance, SSL, DNS, visual regression, content change) accessible from Claude Desktop, Claude Code, Cline, Continue, and any MCP-compatible client.",
+  "type": "module",
+  "bin": {
+    "visualsentinel-mcp-server": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "start": "node dist/index.js",
+    "lint": "tsc --noEmit",
+    "test": "node --test tests/*.test.mjs",
+    "prepublishOnly": "npm run lint && npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "visual-sentinel",
+    "website-monitoring",
+    "uptime",
+    "ssl",
+    "dns",
+    "visual-regression",
+    "claude",
+    "claude-desktop",
+    "cline"
+  ],
+  "author": "Visual Sentinel <support@visualsentinel.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/VisualSentinel/mcp-server#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/VisualSentinel/mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/VisualSentinel/mcp-server/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}