@visualsentinel/mcp-server 0.1.0 → 0.2.2

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tools.ts","../src/resources.ts"],"sourcesContent":["/**\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 ToolAnnotations {\n  title: string;\n  readOnlyHint: boolean;\n  destructiveHint: boolean;\n  idempotentHint: boolean;\n  openWorldHint: boolean;\n}\n\nexport interface ToolDefinition {\n  name: string;\n  /** Human-readable title shown by MCP clients. */\n  title: string;\n  description: string;\n  annotations: ToolAnnotations;\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    title: 'Check Visual Sentinel service health',\n    annotations: {\n      title: 'Check Visual Sentinel service health',\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: true,\n    },\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    title: 'Look up DNS records',\n    annotations: {\n      title: 'Look up DNS records',\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: true,\n    },\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          // The API reads ?type= (not recordType).\n          type: pickString(args, 'recordType'),\n        },\n      }),\n  },\n\n  {\n    name: 'vs_ssl_check',\n    title: 'Inspect an SSL certificate',\n    annotations: {\n      title: 'Inspect an SSL certificate',\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: true,\n    },\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        domain: { ...STR, description: 'Hostname to inspect, e.g. example.com (without protocol).' },\n      },\n      required: ['domain'],\n      additionalProperties: false,\n    },\n    requiresAuth: false,\n    handler: async (args, client) =>\n      client.request('GET', '/api/tools/ssl-check', {\n        auth: false,\n        // The API reads ?domain=. `host` stays as an input alias for 0.1.x callers.\n        query: { domain: pickString(args, 'domain') ?? requireString(args, 'host') },\n      }),\n  },\n\n  {\n    name: 'vs_speed_test',\n    title: 'Run a one-shot speed test',\n    annotations: {\n      title: 'Run a one-shot speed test',\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: true,\n    },\n    description:\n      'Run a one-shot Lighthouse lab test on a URL. Returns the performance score (0 to 100) plus Largest Contentful Paint, First Contentful Paint, Cumulative Layout Shift, Time to First Byte, Total Blocking Time and Speed Index (times in milliseconds). No account needed.',\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    title: 'Check a website',\n    annotations: {\n      title: 'Check a website',\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: true,\n    },\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    title: 'List monitors',\n    annotations: {\n      title: 'List monitors',\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\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    title: 'Get a monitor',\n    annotations: {\n      title: 'Get a monitor',\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\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    title: 'Create a monitor',\n    annotations: {\n      title: 'Create a monitor',\n      readOnlyHint: false,\n      destructiveHint: false,\n      idempotentHint: false,\n      openWorldHint: false,\n    },\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    title: 'Run a monitor check now',\n    annotations: {\n      title: 'Run a monitor check now',\n      readOnlyHint: false,\n      destructiveHint: false,\n      idempotentHint: false,\n      openWorldHint: false,\n    },\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    title: 'Get monitor uptime',\n    annotations: {\n      title: 'Get monitor uptime',\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\n    description:\n      '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.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        id: { ...STR, description: 'Monitor id.' },\n        window: {\n          ...STR,\n          description: 'Preset window: 1h, 6h, 24h, 7d, 30d, 90d, 365d. Default 30d. Ignored when from+to or all are supplied.',\n        },\n        from: {\n          ...STR,\n          description: 'ISO 8601 start of a custom range (e.g. 2026-01-01T00:00:00Z). Must be supplied with `to`.',\n        },\n        to: {\n          ...STR,\n          description: 'ISO 8601 end of a custom range. Must be supplied with `from`.',\n        },\n        all: {\n          type: 'boolean',\n          description: 'Return the full available history from the earliest stored data. Takes precedence over from/to and window.',\n        },\n      },\n      required: ['id'],\n      additionalProperties: false,\n    },\n    requiresAuth: true,\n    handler: async (args, client) => {\n      const from = pickString(args, 'from');\n      const to = pickString(args, 'to');\n      // Precedence mirrors the API: all > from/to > window/period.\n      const query = args['all'] === true\n        ? { all: true }\n        : (from && to)\n          ? { from, to }\n          : { period: pickString(args, 'window') ?? '30d' };\n      return client.request(\n        'GET',\n        `/api/monitors/${encodeURIComponent(requireString(args, 'id'))}/uptime`,\n        { query },\n      );\n    },\n  },\n\n  {\n    name: 'vs_monitors_metrics_bulk',\n    title: 'Get bulk monitor metrics',\n    annotations: {\n      title: 'Get bulk monitor metrics',\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\n    description:\n      '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.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        monitorIds: {\n          type: 'array',\n          items: { type: 'string' },\n          description: 'List of monitor IDs to fetch metrics for (max 100).',\n        },\n        metric: {\n          ...STR,\n          description: 'Metric to return: \"uptime\" or \"response-time\".',\n        },\n        window: {\n          ...STR,\n          description: 'Preset window: 1h, 6h, 24h, 7d, 30d, 90d, 365d. Default 30d. Ignored when from+to or all are supplied.',\n        },\n        from: {\n          ...STR,\n          description: 'ISO 8601 start of a custom range (e.g. 2026-01-01T00:00:00Z). Must be supplied with `to`.',\n        },\n        to: {\n          ...STR,\n          description: 'ISO 8601 end of a custom range. Must be supplied with `from`.',\n        },\n        all: {\n          type: 'boolean',\n          description: 'Return the full available history from the earliest stored data. Takes precedence over from/to and window.',\n        },\n      },\n      required: ['monitorIds', 'metric'],\n      additionalProperties: false,\n    },\n    requiresAuth: true,\n    handler: async (args, client) => {\n      const monitorIds = args['monitorIds'];\n      if (!Array.isArray(monitorIds) || monitorIds.length === 0) {\n        throw new Error('Argument \"monitorIds\" must be a non-empty array.');\n      }\n      const from = pickString(args, 'from');\n      const to = pickString(args, 'to');\n      const body: Record<string, unknown> = {\n        monitorIds,\n        metric: requireString(args, 'metric'),\n      };\n      // Precedence mirrors the API: all > from/to > window/period.\n      if (args['all'] === true) {\n        body['all'] = true;\n      } else if (from && to) {\n        body['from'] = from;\n        body['to'] = to;\n      } else {\n        body['period'] = pickString(args, 'window') ?? '30d';\n      }\n      return client.request('POST', '/api/monitors/metrics', { body });\n    },\n  },\n\n  {\n    name: 'vs_incidents_list',\n    title: 'List incidents',\n    annotations: {\n      title: 'List incidents',\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\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    title: 'Get an incident',\n    annotations: {\n      title: 'Get an incident',\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\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    title: 'List alerts',\n    annotations: {\n      title: 'List alerts',\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\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    title: 'Acknowledge an alert',\n    annotations: {\n      title: 'Acknowledge an alert',\n      readOnlyHint: false,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\n    description: 'Acknowledge an alert by id. The acknowledgement is recorded against the account that authorised this connection.',\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    title: 'List status pages',\n    annotations: {\n      title: 'List status pages',\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\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    title: 'List servers',\n    annotations: {\n      title: 'List servers',\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\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","/**\n * MCP resources: read-only reference material the assistant can attach as\n * context. Static on purpose, so they work without an API key and never touch\n * account data. Plan limits come from the public pricing page; check\n * https://visualsentinel.com/pricing for current prices.\n */\n\nimport { TOOLS } from './tools.js';\n\nexport interface ResourceDefinition {\n  uri: string;\n  name: string;\n  title: string;\n  description: string;\n  mimeType: string;\n  read: () => string;\n}\n\nconst PLANS_AS_OF = '2026-10-16';\n\nconst PLANS = `# Visual Sentinel plans and limits (as of ${PLANS_AS_OF})\n\nPrices and the current list are always at https://visualsentinel.com/pricing. There is no free plan for new accounts: a new workspace gets a first check of its site, then a 7-day trial (card required) or a paid plan.\n\n| Plan | Monitors | Fastest uptime check | Visual pages | Status pages | API keys and MCP account tools |\n|---|---|---|---|---|---|\n| Solo | 10 | every 5 minutes | 1 site, every 30 minutes | 1 | no |\n| Starter | 15 | every 5 minutes | 5, every 15 minutes | 1 | no |\n| Business | 60 | every 1 minute | 60, every 15 minutes | 5 | yes |\n| Agency | 300 | every 1 minute | 300, every 15 minutes | 50 | yes |\n\n- The five public tools (vs_health, vs_dns_check, vs_ssl_check, vs_speed_test, vs_website_check) need no account.\n- The twelve account tools need an API key, which is available on the Business and Agency plans. Create one at https://visualsentinel.com/settings/api-keys.\n- Checks run from Europe and the US. Alert channels on every plan: email, Slack, Discord, Microsoft Teams, Telegram, PagerDuty, Opsgenie, webhooks, WhatsApp, Prometheus, and push notifications in the mobile app.\n`;\n\nconst HELP = `# Using the Visual Sentinel MCP server\n\nVisual Sentinel catches pages that look broken even when the site is up. It watches uptime, performance, SSL certificates, DNS, visual changes and content changes.\n\n## Start without an account\nAsk for a DNS lookup, an SSL certificate check, a speed test or a website check on any public site. These five tools need no account or key.\n\n## Connect your account\n1. Get an API key (Business and Agency plans): https://visualsentinel.com/settings/api-keys\n2. Set it as VS_API_KEY (or VISUALSENTINEL_API_KEY) in your MCP client's environment for this server.\n3. Restart the client. Monitor, uptime, incident, alert, status-page and server tools now work.\n\n## Ready-made prompts\ncheck_website_health, investigate_broken_site, pre_launch_checklist and triage_open_incidents.\n\n## Links\n- Docs and install: https://visualsentinel.com/mcp\n- API reference: https://visualsentinel.com/docs\n- Pricing: https://visualsentinel.com/pricing\n- Source: https://github.com/VisualSentinel/mcp-server\n- Support: https://visualsentinel.com/contact\n`;\n\nfunction toolsReference(): string {\n  const rows = TOOLS.map(\n    (t) => `| ${t.name} | ${t.requiresAuth ? 'API key (Business and Agency)' : 'none'} | ${t.annotations.readOnlyHint ? 'read-only' : 'changes data'} | ${(t.description.split('. ')[0] ?? '').replace(/\\.$/, '')} |`,\n  );\n  return [\n    '# Visual Sentinel tools',\n    '',\n    '| Tool | Needs | Type | What it does |',\n    '|---|---|---|---|',\n    ...rows,\n    '',\n  ].join('\\n');\n}\n\nexport const RESOURCES: ResourceDefinition[] = [\n  {\n    uri: 'visualsentinel://plans',\n    name: 'plans',\n    title: 'Plans and limits',\n    description: 'Monitor counts, check frequencies and which plans include API keys and the MCP account tools.',\n    mimeType: 'text/markdown',\n    read: () => PLANS,\n  },\n  {\n    uri: 'visualsentinel://help',\n    name: 'help',\n    title: 'Help and setup',\n    description: 'How to use the server without an account, how to add an API key, and where the docs are.',\n    mimeType: 'text/markdown',\n    read: () => HELP,\n  },\n  {\n    uri: 'visualsentinel://tools',\n    name: 'tools',\n    title: 'Tool reference',\n    description: 'Every tool, whether it needs an API key, and whether it is read-only.',\n    mimeType: 'text/markdown',\n    read: toolsReference,\n  },\n];\n\nexport function findResource(uri: string): ResourceDefinition | undefined {\n  return RESOURCES.find((r) => r.uri === uri);\n}\n"],"mappings":"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","names":[]}

package/dist/tools.d.ts

@@ -0,0 +1,38 @@
+import { ApiClient } from './api-client.js';
+
+/**
+ * Tool registry for the Visual Sentinel MCP server.
+ *
+ * Each tool wraps a single Visual Sentinel REST endpoint with a JSON Schema
+ * input and a structured handler. Public-tool handlers (DNS check, SSL check,
+ * speed test, website check, health) run without authentication; everything
+ * else requires `VS_API_KEY`.
+ */
+
+interface ToolInput {
+    type: 'object';
+    properties: Record<string, unknown>;
+    required?: string[];
+    additionalProperties?: boolean;
+}
+interface ToolAnnotations {
+    title: string;
+    readOnlyHint: boolean;
+    destructiveHint: boolean;
+    idempotentHint: boolean;
+    openWorldHint: boolean;
+}
+interface ToolDefinition {
+    name: string;
+    /** Human-readable title shown by MCP clients. */
+    title: string;
+    description: string;
+    annotations: ToolAnnotations;
+    inputSchema: ToolInput;
+    requiresAuth: boolean;
+    handler: (args: Record<string, unknown>, client: ApiClient) => Promise<unknown>;
+}
+declare const TOOLS: ToolDefinition[];
+declare function findTool(name: string): ToolDefinition | undefined;
+
+export { TOOLS, type ToolAnnotations, type ToolDefinition, findTool };

package/dist/tools.js

@@ -0,0 +1,546 @@
+#!/usr/bin/env node
+
+// 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",
+    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",
+      properties: {},
+      additionalProperties: false
+    },
+    requiresAuth: false,
+    handler: async (_args, client) => client.request("GET", "/api/health", { auth: false })
+  },
+  {
+    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",
+      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"),
+        // 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: {
+        domain: { ...STR, description: "Hostname to inspect, e.g. example.com (without protocol)." }
+      },
+      required: ["domain"],
+      additionalProperties: false
+    },
+    requiresAuth: false,
+    handler: async (args, client) => client.request("GET", "/api/tools/ssl-check", {
+      auth: false,
+      // 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 Lighthouse lab test on a URL. Returns the performance score (0 to 100) plus Largest Contentful Paint, First Contentful Paint, Cumulative Layout Shift, Time to First Byte, Total Blocking Time and Speed Index (times in milliseconds). No account needed.",
+    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",
+    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",
+      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",
+    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",
+      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",
+    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",
+      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",
+    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",
+      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",
+    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",
+      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",
+    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: "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) => {
+      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",
+      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",
+    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",
+      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",
+    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",
+      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",
+    title: "Acknowledge an alert",
+    annotations: {
+      title: "Acknowledge an alert",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    },
+    description: "Acknowledge an alert by id. The acknowledgement is recorded against the account that authorised this connection.",
+    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",
+    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",
+      properties: {},
+      additionalProperties: false
+    },
+    requiresAuth: true,
+    handler: async (_args, client) => client.request("GET", "/api/status-pages")
+  },
+  {
+    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",
+      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);
+}
+export {
+  TOOLS,
+  findTool
+};
+//# sourceMappingURL=tools.js.map