@visualsentinel/mcp-server 0.1.0 → 0.2.1

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 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.2.1] - 2026-10-16
+
+### Fixed
+
+* `vs_ssl_check` sent `?host=` but the API reads `?domain=`, so every call returned a 400. The tool now takes `domain` (`host` still works as an alias). The unsupported `port` input is removed.
+* `vs_dns_check` sent `recordType`, which the API ignored. It now sends `type`, so the record-type filter works.
+* The server now reports its real version in the MCP handshake instead of a fixed `0.1.0`.
+
+### Added
+
+* Every tool has a `title` and the MCP annotations `readOnlyHint`, `destructiveHint`, `idempotentHint` and `openWorldHint`, as AI directories require.
+* `mcpName` (`io.github.VisualSentinel/mcp-server`) and `server.json` for the official MCP Registry.
+* `.cursor-plugin/plugin.json`, `.claude-plugin/plugin.json`, `.mcp.json` and `mcp.json` for the Cursor Marketplace and Grok Bot, `llms-install.md` for Cline, a `Dockerfile` for the Docker MCP Catalog and Glama, and `gemini-extension.json`.
+
+## [0.2.0] - 2026-06-04
+
+### Added
+
+* New tool `vs_monitors_metrics_bulk`: fetches uptime or response-time metrics for up to 100 monitors in a single API call. Accepts `monitorIds` (array), `metric` (`uptime` | `response-time`), and either a preset `window` or custom `from`+`to` ISO 8601 range. POSTs to `POST /api/monitors/metrics`.
+* `vs_monitors_uptime`: added `from` and `to` input properties for custom date ranges. When both are supplied the handler sends them as query params instead of `period`, allowing arbitrary historical windows.
+* `all` (boolean) input on `vs_monitors_uptime` and `vs_monitors_metrics_bulk`: requests the full available history from the earliest stored data. Precedence mirrors the API: `all` > `from`/`to` > `window`/`period`. This makes the documented full-history capability actually reachable through the tools.
+
+### Changed
+
+* `vs_monitors_uptime`: input schema now includes `from`, `to`, and expands `window` description to list `1h | 6h | 24h | 7d | 30d | 90d | 365d`. Handler now correctly maps `window` → `period` query param (previously `window` was sent as-is and silently ignored by the API). Default period remains `30d`.
+* `tsup.config.ts`: added `src/tools.ts` and `src/api-client.ts` as explicit entry points so they emit separate dist files importable by tests without bundling index.ts.
+
+### Fixed
+
+* `vs_monitors_uptime` handler was sending `{ window: ... }` in the query string instead of `{ period: ... }`. The Visual Sentinel API only accepts `period`; the old behaviour silently fell back to the server default.
+
 ## [0.1.0] - 2026-04-29
 
 Initial public release.

package/README.md

@@ -1,17 +1,17 @@
 # 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.
+Model Context Protocol server for [Visual Sentinel](https://visualsentinel.com). Visual Sentinel catches pages that look broken even when the site is up. It monitors six layers: uptime, performance, SSL, DNS, visual regression, and content change.
 
-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.
+Connect Claude Desktop, Claude Code, Cursor, Cline, Continue, or any MCP-compatible client so an AI assistant can run DNS, SSL and speed checks on any site with no account. With a Visual Sentinel account and an API key (Business and Agency plans) it can also list and create monitors, fetch incident history, 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
+* **API key (Business and Agency plans):** https://visualsentinel.com/settings/api-keys
 * **Hosted API reference:** https://visualsentinel.com/docs
 
 ## What you get
 
-16 tools spanning the public Visual Sentinel API:
+17 tools spanning the public Visual Sentinel API:
 
 **Public tools (no API key required)**
 
@@ -31,7 +31,8 @@ Connect Claude Desktop, Claude Code, Cline, Continue, or any MCP-compatible clie
 | `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_monitors_uptime` | `GET /api/monitors/{id}/uptime` | Uptime percentage for a preset window, a custom date range, or the full history |
+| `vs_monitors_metrics_bulk` | `POST /api/monitors/metrics` | Uptime or response-time metrics for up to 100 monitors in one call |
 | `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 |
@@ -59,7 +60,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
 }
 ```
 
-Restart Claude Desktop. The 16 tools appear under the tools menu.
+Restart Claude Desktop. The 17 tools appear under the tools menu.
 
 ### Claude Code (CLI)
 
@@ -70,6 +71,30 @@ claude mcp add visualsentinel \
 
 Then export `VS_API_KEY` in the shell where Claude Code runs.
 
+### Cursor and Grok Bot
+
+This repository is also an installable plugin: `.cursor-plugin/plugin.json` and `mcp.json` for the Cursor Marketplace, and `.claude-plugin/plugin.json` and `.mcp.json` for Grok and Claude Code (`grok plugin install VisualSentinel/mcp-server`). Or add the server by hand to `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "visualsentinel": {
+      "command": "npx",
+      "args": ["-y", "@visualsentinel/mcp-server"]
+    }
+  }
+}
+```
+
+### Docker
+
+```bash
+docker build -t visualsentinel-mcp-server .
+docker run -i --rm -e VS_API_KEY visualsentinel-mcp-server
+```
+
+The server also ships as a Gemini CLI extension (`gemini-extension.json`).
+
 ### Cline (VS Code extension)
 
 In Cline's MCP settings, add:
@@ -115,7 +140,7 @@ 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_KEY` | (none) | Required for the 12 authenticated tools (API keys are available on the Business and Agency plans). 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.

package/dist/api-client.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Tiny HTTP client for the Visual Sentinel public API.
+ *
+ * Reads the API key from `VS_API_KEY` (or `VISUALSENTINEL_API_KEY`) once at
+ * construction time. All requests are routed at `https://visualsentinel.com`
+ * unless `VS_API_BASE` overrides it (useful for testing against a local
+ * dev instance).
+ */
+interface ApiClientOptions {
+    apiKey?: string | undefined;
+    baseUrl?: string | undefined;
+    userAgent?: string;
+}
+declare class VsApiError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(message: string, status: number, body: unknown);
+}
+declare class ApiClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly userAgent;
+    constructor(opts?: ApiClientOptions);
+    hasApiKey(): boolean;
+    request<T = unknown>(method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', path: string, options?: {
+        query?: Record<string, string | number | boolean | undefined>;
+        body?: unknown;
+        auth?: boolean;
+    }): Promise<T>;
+}
+
+export { ApiClient, type ApiClientOptions, VsApiError };

package/dist/api-client.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+
+// 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;
+  }
+};
+export {
+  ApiClient,
+  VsApiError
+};
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/api-client.ts"],"sourcesContent":["/**\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"],"mappings":";;;AASA,IAAM,eAAe;AAQd,IAAM,aAAN,cAAyB,MAAM;AAAA,EACpC,YACE,SACgB,QACA,MAChB;AACA,UAAM,OAAO;AAHG;AACA;AAGhB,SAAK,OAAO;AAAA,EACd;AAAA,EALkB;AAAA,EACA;AAKpB;AAEO,IAAM,YAAN,MAAgB;AAAA,EACJ;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,YAAY,OAAyB,CAAC,GAAG;AACvC,SAAK,SACH,KAAK,UACL,QAAQ,IAAI,cACZ,QAAQ,IAAI,0BACZ;AACF,SAAK,WAAW,KAAK,WAAW,QAAQ,IAAI,eAAe,cAAc;AAAA,MACvE;AAAA,MACA;AAAA,IACF;AACA,SAAK,YAAY,KAAK,aAAa;AAAA,EACrC;AAAA,EAEA,YAAqB;AACnB,WAAO,OAAO,KAAK,WAAW,YAAY,KAAK,OAAO,SAAS;AAAA,EACjE;AAAA,EAEA,MAAM,QACJ,QACA,MACA,UAA6G,CAAC,GAClG;AACZ,UAAM,OAAO,QAAQ,QAAQ;AAC7B,QAAI,QAAQ,CAAC,KAAK,UAAU,GAAG;AAC7B,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,UAAM,MAAM,IAAI,IAAI,KAAK,WAAW,GAAG,IAAI,OAAO,IAAI,IAAI,IAAI,KAAK,OAAO;AAC1E,QAAI,QAAQ,OAAO;AACjB,iBAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,QAAQ,KAAK,GAAG;AAClD,YAAI,MAAM,UAAa,MAAM,KAAM,KAAI,aAAa,IAAI,GAAG,OAAO,CAAC,CAAC;AAAA,MACtE;AAAA,IACF;AAEA,UAAM,UAAkC;AAAA,MACtC,QAAQ;AAAA,MACR,cAAc,KAAK;AAAA,IACrB;AACA,QAAI,QAAQ,KAAK,OAAQ,SAAQ,WAAW,IAAI,KAAK;AACrD,QAAI,QAAQ,SAAS,OAAW,SAAQ,cAAc,IAAI;AAE1D,UAAM,MAAM,MAAM,MAAM,KAAK;AAAA,MAC3B;AAAA,MACA;AAAA,MACA,MAAM,QAAQ,SAAS,SAAY,KAAK,UAAU,QAAQ,IAAI,IAAI;AAAA,IACpE,CAAC;AAED,UAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,QAAI,SAAkB;AACtB,QAAI,KAAK,SAAS,GAAG;AACnB,UAAI;AACF,iBAAS,KAAK,MAAM,IAAI;AAAA,MAC1B,QAAQ;AACN,iBAAS;AAAA,MACX;AAAA,IACF;AAEA,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,IAAI;AAAA,QACR,uBAAuB,MAAM,IAAI,IAAI,aAAa,IAAI,MAAM;AAAA,QAC5D,IAAI;AAAA,QACJ;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/index.js

@@ -103,6 +103,14 @@ var TOOLS = [
   // -------------------------------------------------------------------------
   {
     name: "vs_health",
+    title: "Check Visual Sentinel service health",
+    annotations: {
+      title: "Check Visual Sentinel service health",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     description: "Check whether Visual Sentinel itself is up. Returns the service health status. No authentication required.",
     inputSchema: {
       type: "object",
@@ -114,6 +122,14 @@ var TOOLS = [
   },
   {
     name: "vs_dns_check",
+    title: "Look up DNS records",
+    annotations: {
+      title: "Look up DNS records",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     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",
@@ -132,30 +148,47 @@ var TOOLS = [
       auth: false,
       query: {
         domain: requireString(args, "domain"),
-        recordType: pickString(args, "recordType")
+        // The API reads ?type= (not recordType).
+        type: pickString(args, "recordType")
       }
     })
   },
   {
     name: "vs_ssl_check",
+    title: "Inspect an SSL certificate",
+    annotations: {
+      title: "Inspect an SSL certificate",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     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." }
+        domain: { ...STR, description: "Hostname to inspect, e.g. example.com (without protocol)." }
       },
-      required: ["host"],
+      required: ["domain"],
       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") }
+      // The API reads ?domain=. `host` stays as an input alias for 0.1.x callers.
+      query: { domain: pickString(args, "domain") ?? requireString(args, "host") }
     })
   },
   {
     name: "vs_speed_test",
+    title: "Run a one-shot speed test",
+    annotations: {
+      title: "Run a one-shot speed test",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     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",
@@ -173,6 +206,14 @@ var TOOLS = [
   },
   {
     name: "vs_website_check",
+    title: "Check a website",
+    annotations: {
+      title: "Check a website",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
     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",
@@ -193,6 +234,14 @@ var TOOLS = [
   // -------------------------------------------------------------------------
   {
     name: "vs_monitors_list",
+    title: "List monitors",
+    annotations: {
+      title: "List monitors",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     description: "List monitors in the authenticated organization. Optional filters narrow by status, type, or paginate.",
     inputSchema: {
       type: "object",
@@ -219,6 +268,14 @@ var TOOLS = [
   },
   {
     name: "vs_monitors_get",
+    title: "Get a monitor",
+    annotations: {
+      title: "Get a monitor",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     description: "Fetch a single monitor by id, including its current status, last check, and configuration.",
     inputSchema: {
       type: "object",
@@ -233,6 +290,14 @@ var TOOLS = [
   },
   {
     name: "vs_monitors_create",
+    title: "Create a monitor",
+    annotations: {
+      title: "Create a monitor",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: false
+    },
     description: "Create a new monitor. Provide at least name, url, and type. Returns the created monitor including its assigned id.",
     inputSchema: {
       type: "object",
@@ -268,6 +333,14 @@ var TOOLS = [
   },
   {
     name: "vs_monitors_check_now",
+    title: "Run a monitor check now",
+    annotations: {
+      title: "Run a monitor check now",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: false
+    },
     description: "Trigger an immediate check for a monitor (in addition to its scheduled cadence). Returns the freshly-collected check result.",
     inputSchema: {
       type: "object",
@@ -282,26 +355,127 @@ var TOOLS = [
   },
   {
     name: "vs_monitors_uptime",
-    description: "Fetch the uptime percentage and outage breakdown for a monitor over a window (default last 30 days).",
+    title: "Get monitor uptime",
+    annotations: {
+      title: "Get monitor uptime",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    },
+    description: "Fetch the uptime percentage and time-series breakdown for a monitor. Use `window` for a preset window (24h, 7d, 30d, 90d, 365d; default 30d), supply both `from` and `to` (ISO 8601) for a custom date range, or set `all: true` for the full available history.",
     inputSchema: {
       type: "object",
       properties: {
         id: { ...STR, description: "Monitor id." },
         window: {
           ...STR,
-          description: "Window: 24h, 7d, 30d, 90d, 365d. Default 30d."
+          description: "Preset window: 1h, 6h, 24h, 7d, 30d, 90d, 365d. Default 30d. Ignored when from+to or all are supplied."
+        },
+        from: {
+          ...STR,
+          description: "ISO 8601 start of a custom range (e.g. 2026-01-01T00:00:00Z). Must be supplied with `to`."
+        },
+        to: {
+          ...STR,
+          description: "ISO 8601 end of a custom range. Must be supplied with `from`."
+        },
+        all: {
+          type: "boolean",
+          description: "Return the full available history from the earliest stored data. Takes precedence over from/to and window."
         }
       },
       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") }
-    })
+    handler: async (args, client) => {
+      const from = pickString(args, "from");
+      const to = pickString(args, "to");
+      const query = args["all"] === true ? { all: true } : from && to ? { from, to } : { period: pickString(args, "window") ?? "30d" };
+      return client.request(
+        "GET",
+        `/api/monitors/${encodeURIComponent(requireString(args, "id"))}/uptime`,
+        { query }
+      );
+    }
+  },
+  {
+    name: "vs_monitors_metrics_bulk",
+    title: "Get bulk monitor metrics",
+    annotations: {
+      title: "Get bulk monitor metrics",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    },
+    description: "Fetch uptime or response-time metrics for up to 100 monitors in a single request. Use `window` for a preset window (1h, 6h, 24h, 7d, 30d, 90d, 365d; default 30d), supply both `from` and `to` (ISO 8601) for a custom date range, or set `all: true` for the full available history. Returns a `monitors` object keyed by monitor id.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        monitorIds: {
+          type: "array",
+          items: { type: "string" },
+          description: "List of monitor IDs to fetch metrics for (max 100)."
+        },
+        metric: {
+          ...STR,
+          description: 'Metric to return: "uptime" or "response-time".'
+        },
+        window: {
+          ...STR,
+          description: "Preset window: 1h, 6h, 24h, 7d, 30d, 90d, 365d. Default 30d. Ignored when from+to or all are supplied."
+        },
+        from: {
+          ...STR,
+          description: "ISO 8601 start of a custom range (e.g. 2026-01-01T00:00:00Z). Must be supplied with `to`."
+        },
+        to: {
+          ...STR,
+          description: "ISO 8601 end of a custom range. Must be supplied with `from`."
+        },
+        all: {
+          type: "boolean",
+          description: "Return the full available history from the earliest stored data. Takes precedence over from/to and window."
+        }
+      },
+      required: ["monitorIds", "metric"],
+      additionalProperties: false
+    },
+    requiresAuth: true,
+    handler: async (args, client) => {
+      const monitorIds = args["monitorIds"];
+      if (!Array.isArray(monitorIds) || monitorIds.length === 0) {
+        throw new Error('Argument "monitorIds" must be a non-empty array.');
+      }
+      const from = pickString(args, "from");
+      const to = pickString(args, "to");
+      const body = {
+        monitorIds,
+        metric: requireString(args, "metric")
+      };
+      if (args["all"] === true) {
+        body["all"] = true;
+      } else if (from && to) {
+        body["from"] = from;
+        body["to"] = to;
+      } else {
+        body["period"] = pickString(args, "window") ?? "30d";
+      }
+      return client.request("POST", "/api/monitors/metrics", { body });
+    }
   },
   {
     name: "vs_incidents_list",
+    title: "List incidents",
+    annotations: {
+      title: "List incidents",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     description: "List incidents for the authenticated organization. Filter by status (OPEN/RESOLVED), monitor id, or paginate.",
     inputSchema: {
       type: "object",
@@ -325,6 +499,14 @@ var TOOLS = [
   },
   {
     name: "vs_incidents_get",
+    title: "Get an incident",
+    annotations: {
+      title: "Get an incident",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     description: "Fetch a single incident with its full check history and root-cause hints.",
     inputSchema: {
       type: "object",
@@ -339,6 +521,14 @@ var TOOLS = [
   },
   {
     name: "vs_alerts_list",
+    title: "List alerts",
+    annotations: {
+      title: "List alerts",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     description: "List alerts for the authenticated organization. Filter by status (UNACKNOWLEDGED/ACKNOWLEDGED/RESOLVED) or paginate.",
     inputSchema: {
       type: "object",
@@ -360,6 +550,14 @@ var TOOLS = [
   },
   {
     name: "vs_alerts_acknowledge",
+    title: "Acknowledge an alert",
+    annotations: {
+      title: "Acknowledge an alert",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     description: "Acknowledge an alert by id. Acknowledgement is recorded with the calling API key's user.",
     inputSchema: {
       type: "object",
@@ -377,6 +575,14 @@ var TOOLS = [
   },
   {
     name: "vs_status_pages_list",
+    title: "List status pages",
+    annotations: {
+      title: "List status pages",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     description: "List public-facing status pages owned by the authenticated organization.",
     inputSchema: {
       type: "object",
@@ -388,6 +594,14 @@ var TOOLS = [
   },
   {
     name: "vs_servers_list",
+    title: "List servers",
+    annotations: {
+      title: "List servers",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     description: "List servers (origins) registered in the authenticated organization.",
     inputSchema: {
       type: "object",
@@ -409,11 +623,13 @@ function findTool(name) {
 
 // src/index.ts
 var SERVER_NAME = "visualsentinel";
-var SERVER_VERSION = "0.1.0";
+var SERVER_VERSION = "0.2.1";
 function toMcpToolDescriptor(tool) {
   return {
     name: tool.name,
+    title: tool.title,
     description: tool.description,
+    annotations: tool.annotations,
     inputSchema: tool.inputSchema
   };
 }