@checkview/mcp-server 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CheckView
+
+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,50 @@
+# CheckView MCP Server
+
+Manage your CheckView form and WooCommerce checkout tests from AI assistants
+like Claude Code and Cursor.
+
+## Quick start
+
+No install needed. Run it with `npx`:
+
+```bash
+claude mcp add checkview \
+  --env CHECKVIEW_API_URL=https://api.checkview.io/api/v1 \
+  --env CHECKVIEW_API_KEY=cvpat_YOUR_TOKEN \
+  -- npx -y @checkview/mcp-server
+```
+
+Or add it to any MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "checkview": {
+      "command": "npx",
+      "args": ["-y", "@checkview/mcp-server"],
+      "env": {
+        "CHECKVIEW_API_URL": "https://api.checkview.io/api/v1",
+        "CHECKVIEW_API_KEY": "cvpat_YOUR_TOKEN"
+      }
+    }
+  }
+}
+```
+
+## Authentication
+
+Create a Personal Access Token in the CheckView dashboard under
+**Settings → API Tokens**, and use it as `CHECKVIEW_API_KEY`.
+
+| Variable | Required | Value |
+| --- | --- | --- |
+| `CHECKVIEW_API_KEY` | yes | Your `cvpat_…` token |
+| `CHECKVIEW_API_URL` | yes | `https://api.checkview.io/api/v1` |
+
+## What you can do
+
+Create and run test flows, fetch results and AI failure summaries, manage
+websites and team members, generate UX audit reports, check usage, and more,
+all in natural language from your editor.
+
+Requires Node.js 18+.

package/dist/api-client.d.ts

@@ -0,0 +1,44 @@
+export declare class ApiError extends Error {
+    status: number;
+    type?: string;
+    detail: string;
+    isReplay: boolean;
+    constructor(status: number, detail: string, type?: string, isReplay?: boolean);
+}
+export declare class ApiClient {
+    private baseUrl;
+    private apiKey;
+    private organizationOverride;
+    constructor(baseUrl: string, apiKey: string);
+    setOrganizationOverride(orgId: string): void;
+    clearOrganizationOverride(): void;
+    getOrganizationOverride(): string | null;
+    get<T = unknown>(path: string, queryParams?: Record<string, string | undefined>, signal?: AbortSignal): Promise<{
+        body: T;
+        headers: Headers;
+    }>;
+    post<T = unknown>(path: string, body?: unknown, idempotencyKey?: string, signal?: AbortSignal): Promise<{
+        body: T;
+        headers: Headers;
+    }>;
+    put<T = unknown>(path: string, body?: unknown, idempotencyKey?: string, signal?: AbortSignal): Promise<{
+        body: T;
+        headers: Headers;
+    }>;
+    patch<T = unknown>(path: string, body?: unknown, idempotencyKey?: string, signal?: AbortSignal): Promise<{
+        body: T;
+        headers: Headers;
+    }>;
+    delete<T = unknown>(path: string, idempotencyKey?: string, signal?: AbortSignal): Promise<{
+        body: T;
+        headers: Headers;
+    }>;
+    private defaultHeaders;
+    private buildUrl;
+    private parseError;
+}
+/**
+ * Generate a stable SHA-256 idempotency key from input data.
+ */
+export declare function idempotencyKey(input: string): string;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAEA,qBAAa,QAAS,SAAQ,KAAK;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;gBAEN,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,UAAQ;CAQ5E;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,oBAAoB,CAAuB;gBAEvC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAK3C,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI5C,yBAAyB,IAAI,IAAI;IAIjC,uBAAuB,IAAI,MAAM,GAAG,IAAI;IAIlC,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAChD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAgBnC,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,cAAc,CAAC,EAAE,MAAM,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IA0BnC,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,cAAc,CAAC,EAAE,MAAM,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAyBnC,KAAK,CAAC,CAAC,GAAG,OAAO,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,cAAc,CAAC,EAAE,MAAM,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAyBnC,MAAM,CAAC,CAAC,GAAG,OAAO,EACtB,IAAI,EAAE,MAAM,EACZ,cAAc,CAAC,EAAE,MAAM,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAwBzC,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,QAAQ;YAeF,UAAU;CAmBzB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/api-client.js

@@ -0,0 +1,164 @@
+import { createHash } from "node:crypto";
+export class ApiError extends Error {
+    status;
+    type;
+    detail;
+    isReplay;
+    constructor(status, detail, type, isReplay = false) {
+        super(detail);
+        this.name = "ApiError";
+        this.status = status;
+        this.type = type;
+        this.detail = detail;
+        this.isReplay = isReplay;
+    }
+}
+export class ApiClient {
+    baseUrl;
+    apiKey;
+    organizationOverride = null;
+    constructor(baseUrl, apiKey) {
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+        this.apiKey = apiKey;
+    }
+    setOrganizationOverride(orgId) {
+        this.organizationOverride = orgId;
+    }
+    clearOrganizationOverride() {
+        this.organizationOverride = null;
+    }
+    getOrganizationOverride() {
+        return this.organizationOverride;
+    }
+    async get(path, queryParams, signal) {
+        const url = this.buildUrl(path, queryParams);
+        const response = await fetch(url, {
+            method: "GET",
+            headers: this.defaultHeaders(),
+            signal,
+        });
+        if (!response.ok) {
+            throw await this.parseError(response);
+        }
+        const body = (await response.json());
+        return { body, headers: response.headers };
+    }
+    async post(path, body, idempotencyKey, signal) {
+        const headers = this.defaultHeaders();
+        if (idempotencyKey) {
+            headers["Idempotency-Key"] = idempotencyKey;
+        }
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method: "POST",
+            headers,
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+            signal,
+        });
+        if (!response.ok) {
+            throw await this.parseError(response);
+        }
+        // Some endpoints return 204 No Content
+        if (response.status === 204) {
+            return { body: undefined, headers: response.headers };
+        }
+        const responseBody = (await response.json());
+        return { body: responseBody, headers: response.headers };
+    }
+    async put(path, body, idempotencyKey, signal) {
+        const headers = this.defaultHeaders();
+        if (idempotencyKey) {
+            headers["Idempotency-Key"] = idempotencyKey;
+        }
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method: "PUT",
+            headers,
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+            signal,
+        });
+        if (!response.ok) {
+            throw await this.parseError(response);
+        }
+        if (response.status === 204) {
+            return { body: undefined, headers: response.headers };
+        }
+        const responseBody = (await response.json());
+        return { body: responseBody, headers: response.headers };
+    }
+    async patch(path, body, idempotencyKey, signal) {
+        const headers = this.defaultHeaders();
+        if (idempotencyKey) {
+            headers["Idempotency-Key"] = idempotencyKey;
+        }
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method: "PATCH",
+            headers,
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+            signal,
+        });
+        if (!response.ok) {
+            throw await this.parseError(response);
+        }
+        if (response.status === 204) {
+            return { body: undefined, headers: response.headers };
+        }
+        const responseBody = (await response.json());
+        return { body: responseBody, headers: response.headers };
+    }
+    async delete(path, idempotencyKey, signal) {
+        const headers = this.defaultHeaders();
+        if (idempotencyKey) {
+            headers["Idempotency-Key"] = idempotencyKey;
+        }
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method: "DELETE",
+            headers,
+            signal,
+        });
+        if (!response.ok) {
+            throw await this.parseError(response);
+        }
+        if (response.status === 204) {
+            return { body: undefined, headers: response.headers };
+        }
+        const responseBody = (await response.json());
+        return { body: responseBody, headers: response.headers };
+    }
+    defaultHeaders() {
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json",
+        };
+        if (this.organizationOverride) {
+            headers["X-Tenant"] = this.organizationOverride;
+        }
+        return headers;
+    }
+    buildUrl(path, queryParams) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (queryParams) {
+            for (const [key, value] of Object.entries(queryParams)) {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.set(key, value);
+                }
+            }
+        }
+        return url.toString();
+    }
+    async parseError(response) {
+        const isReplay = response.headers.get("X-Idempotency-Replay") === "true";
+        try {
+            const body = await response.json();
+            return new ApiError(response.status, body.detail || body.message || response.statusText, body.type, isReplay);
+        }
+        catch {
+            return new ApiError(response.status, response.statusText, undefined, isReplay);
+        }
+    }
+}
+/**
+ * Generate a stable SHA-256 idempotency key from input data.
+ */
+export function idempotencyKey(input) {
+    return createHash("sha256").update(input).digest("hex");
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/format.d.ts

@@ -0,0 +1,35 @@
+export interface TestRunStep {
+    id: string;
+    index: number;
+    type: string;
+    status: string;
+    error_message?: string | null;
+    error_type?: string | null;
+    screenshot_url?: string | null;
+    data?: unknown;
+    [key: string]: unknown;
+}
+export interface TestRunDetail {
+    id: string;
+    status: string;
+    started_at?: string | null;
+    ended_at?: string | null;
+    blocker?: string | null;
+    blocker_message?: string | null;
+    website?: {
+        name: string;
+        url: string;
+    } | null;
+    test_flow?: {
+        name: string;
+        type: string;
+    } | null;
+    steps?: TestRunStep[];
+    [key: string]: unknown;
+}
+/**
+ * Format a test run detail into a human-readable text block.
+ * Strips infrastructure noise (job IDs, signed URLs).
+ */
+export declare function formatTestRun(testRun: TestRunDetail): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/C,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAClD,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAkE5D"}

package/dist/format.js

@@ -0,0 +1,57 @@
+/**
+ * Format a test run detail into a human-readable text block.
+ * Strips infrastructure noise (job IDs, signed URLs).
+ */
+export function formatTestRun(testRun) {
+    const lines = [];
+    // Header
+    const status = testRun.status ?? "unknown";
+    const statusIcon = status === "success"
+        ? "PASSED"
+        : status === "error"
+            ? "FAILED"
+            : status.toUpperCase();
+    lines.push(`## Test Result: ${statusIcon}`);
+    lines.push("");
+    // Context
+    if (testRun.website) {
+        lines.push(`**Website:** ${testRun.website.name} (${testRun.website.url})`);
+    }
+    if (testRun.test_flow) {
+        lines.push(`**Test Flow:** ${testRun.test_flow.name} (${testRun.test_flow.type})`);
+    }
+    lines.push(`**Test Run ID:** ${testRun.id}`);
+    // Timing
+    if (testRun.started_at && testRun.ended_at) {
+        const start = new Date(testRun.started_at);
+        const end = new Date(testRun.ended_at);
+        const durationSec = ((end.getTime() - start.getTime()) / 1000).toFixed(1);
+        lines.push(`**Duration:** ${durationSec}s`);
+    }
+    // Blocker warning
+    if (testRun.blocker) {
+        lines.push("");
+        lines.push(`**BLOCKER:** ${testRun.blocker}${testRun.blocker_message ? ` — ${testRun.blocker_message}` : ""}`);
+    }
+    // Steps
+    const steps = testRun.steps ?? [];
+    if (steps.length > 0) {
+        lines.push("");
+        lines.push(`### Steps (${steps.length} total)`);
+        lines.push("");
+        for (const step of steps) {
+            const ss = step.status ?? "unknown";
+            const stepStatus = ss === "success" ? "PASS" : ss === "error" ? "FAIL" : ss.toUpperCase();
+            let line = `${step.index}. [${stepStatus}] ${step.type}`;
+            if (step.error_message) {
+                line += ` — ${step.error_message}`;
+            }
+            if (step.error_type) {
+                line += ` (${step.error_type})`;
+            }
+            lines.push(line);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ApiClient } from "./api-client.js";
+import { registerAbortTestTool } from "./tools/abort-test.js";
+import { registerAddTestCommentTool } from "./tools/add-test-comment.js";
+import { registerAddWebsiteTool } from "./tools/add-website.js";
+import { registerCheckWebsiteAvailabilityTool } from "./tools/check-website-availability.js";
+import { registerCheckWebsiteHealthTool } from "./tools/check-website-health.js";
+import { registerCompareTestRunsTool } from "./tools/compare-test-runs.js";
+import { registerCreateFormTestFlowTool } from "./tools/create-form-test-flow.js";
+import { registerCreateTestFlowTool } from "./tools/create-test-flow.js";
+import { registerDeleteInvitationTool } from "./tools/delete-invitation.js";
+import { registerDeleteTestCommentTool } from "./tools/delete-test-comment.js";
+import { registerGetAiSummaryTool } from "./tools/get-ai-summary.js";
+import { registerGetCurrentOrganizationTool } from "./tools/get-current-organization.js";
+import { registerGetGenerationStatusTool } from "./tools/get-generation-status.js";
+import { registerGetMetricsTool } from "./tools/get-metrics.js";
+import { registerGetOrganizationTool } from "./tools/get-organization.js";
+import { registerGetOrganizationStatsTool } from "./tools/get-organization-stats.js";
+import { registerGetResultsTool } from "./tools/get-results.js";
+import { registerGetSettingsTool } from "./tools/get-settings.js";
+import { registerGetStepScreenshotTool } from "./tools/get-step-screenshot.js";
+import { registerGetTestFlowTool } from "./tools/get-test-flow.js";
+import { registerGetTestHistoryTool } from "./tools/get-test-history.js";
+import { registerGetTestRunVideoTool } from "./tools/get-test-run-video.js";
+import { registerGetTestStepDetailsTool } from "./tools/get-test-step-details.js";
+import { registerGetUsageTool } from "./tools/get-usage.js";
+import { registerGetUsageReportsTool } from "./tools/get-usage-reports.js";
+import { registerGetUxAuditReportTool } from "./tools/get-ux-audit-report.js";
+import { registerGetWebsiteTool } from "./tools/get-website.js";
+import { registerGetWebsiteAnalyticsTool } from "./tools/get-website-analytics.js";
+import { registerGetWebsiteLogsTool } from "./tools/get-website-logs.js";
+import { registerGetWebsiteScreenshotTool } from "./tools/get-website-screenshot.js";
+import { registerGetWebsiteSettingsTool } from "./tools/get-website-settings.js";
+import { registerInviteTeamMemberTool } from "./tools/invite-team-member.js";
+import { registerListFormsTool } from "./tools/list-forms.js";
+import { registerListOrganizationsTool } from "./tools/list-organizations.js";
+import { registerListTeamMembersTool } from "./tools/list-team-members.js";
+import { registerListTestCommentsTool } from "./tools/list-test-comments.js";
+import { registerListTestFlowsTool } from "./tools/list-test-flows.js";
+import { registerListTestFlowStepsTool } from "./tools/list-test-flow-steps.js";
+import { registerListTestRunsTool } from "./tools/list-test-runs.js";
+import { registerListUxAuditsTool } from "./tools/list-ux-audits.js";
+import { registerListWebsitesTool } from "./tools/list-websites.js";
+import { registerManageNotificationSettingsTool } from "./tools/manage-notification-settings.js";
+import { registerPauseWebsiteTool } from "./tools/pause-website.js";
+import { registerRegenerateTestStepsTool } from "./tools/regenerate-test-steps.js";
+import { registerReinitializeTestFlowTool } from "./tools/reinitialize-test-flow.js";
+import { registerRemoveTeamMemberTool } from "./tools/remove-team-member.js";
+import { registerRemoveTestFlowTool } from "./tools/remove-test-flow.js";
+import { registerRemoveWebsiteTool } from "./tools/remove-website.js";
+import { registerResumeWebsiteTool } from "./tools/resume-website.js";
+import { registerRunAllTestsTool } from "./tools/run-all-tests.js";
+import { registerRunTestTool } from "./tools/run-test.js";
+import { registerRunUxAuditTool } from "./tools/run-ux-audit.js";
+import { registerSetOrganizationTool } from "./tools/set-organization.js";
+import { registerTestUrlTool } from "./tools/test-url.js";
+import { registerUpdateOrganizationTool } from "./tools/update-organization.js";
+import { registerUpdateScheduleTool } from "./tools/update-schedule.js";
+import { registerUpdateSettingsTool } from "./tools/update-settings.js";
+import { registerUpdateTeamMemberTool } from "./tools/update-team-member.js";
+import { registerUpdateTestFlowTool } from "./tools/update-test-flow.js";
+import { registerUpdateTestFlowStepsTool } from "./tools/update-test-flow-steps.js";
+import { registerUpdateWebsiteTool } from "./tools/update-website.js";
+// Validate env vars
+const apiUrl = process.env.CHECKVIEW_API_URL;
+const apiKey = process.env.CHECKVIEW_API_KEY;
+if (!apiUrl || !apiKey) {
+    process.stderr.write("Error: Missing required environment variables.\n" +
+        "Set CHECKVIEW_API_URL and CHECKVIEW_API_KEY.\n" +
+        "Example: CHECKVIEW_API_URL=https://api.checkview.io/api/v1 CHECKVIEW_API_KEY=cvpat_...\n");
+    process.exit(1);
+}
+const server = new McpServer({ name: "checkview", version: "1.1.0" }, { capabilities: { logging: {} } });
+const client = new ApiClient(apiUrl, apiKey);
+// Register all tools
+registerAbortTestTool(server, client);
+registerAddTestCommentTool(server, client);
+registerAddWebsiteTool(server, client);
+registerCheckWebsiteAvailabilityTool(server, client);
+registerCheckWebsiteHealthTool(server, client);
+registerCompareTestRunsTool(server, client);
+registerCreateFormTestFlowTool(server, client);
+registerCreateTestFlowTool(server, client);
+registerDeleteInvitationTool(server, client);
+registerDeleteTestCommentTool(server, client);
+registerGetAiSummaryTool(server, client);
+registerGetCurrentOrganizationTool(server, client);
+registerGetGenerationStatusTool(server, client);
+registerGetMetricsTool(server, client);
+registerGetOrganizationTool(server, client);
+registerGetOrganizationStatsTool(server, client);
+registerGetResultsTool(server, client);
+registerGetSettingsTool(server, client);
+registerGetStepScreenshotTool(server, client);
+registerGetTestFlowTool(server, client);
+registerGetTestHistoryTool(server, client);
+registerGetTestRunVideoTool(server, client);
+registerGetTestStepDetailsTool(server, client);
+registerGetUsageTool(server, client);
+registerGetUsageReportsTool(server, client);
+registerGetUxAuditReportTool(server, client);
+registerGetWebsiteTool(server, client);
+registerGetWebsiteAnalyticsTool(server, client);
+registerGetWebsiteLogsTool(server, client);
+registerGetWebsiteScreenshotTool(server, client);
+registerGetWebsiteSettingsTool(server, client);
+registerInviteTeamMemberTool(server, client);
+registerListFormsTool(server, client);
+registerListOrganizationsTool(server, client);
+registerListTeamMembersTool(server, client);
+registerListTestCommentsTool(server, client);
+registerListTestFlowsTool(server, client);
+registerListTestFlowStepsTool(server, client);
+registerListTestRunsTool(server, client);
+registerListUxAuditsTool(server, client);
+registerListWebsitesTool(server, client);
+registerManageNotificationSettingsTool(server, client);
+registerPauseWebsiteTool(server, client);
+registerRegenerateTestStepsTool(server, client);
+registerReinitializeTestFlowTool(server, client);
+registerRemoveTeamMemberTool(server, client);
+registerRemoveTestFlowTool(server, client);
+registerRemoveWebsiteTool(server, client);
+registerResumeWebsiteTool(server, client);
+registerRunAllTestsTool(server, client);
+registerRunTestTool(server, client);
+registerRunUxAuditTool(server, client);
+registerSetOrganizationTool(server, client);
+registerTestUrlTool(server, client);
+registerUpdateOrganizationTool(server, client);
+registerUpdateScheduleTool(server, client);
+registerUpdateSettingsTool(server, client);
+registerUpdateTeamMemberTool(server, client);
+registerUpdateTestFlowTool(server, client);
+registerUpdateTestFlowStepsTool(server, client);
+registerUpdateWebsiteTool(server, client);
+// Connect via stdio transport
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/polling.d.ts

@@ -0,0 +1,13 @@
+export interface PollOptions<T> {
+    intervalMs: number;
+    timeoutMs: number;
+    signal?: AbortSignal;
+    onProgress?: (result: T) => void;
+}
+/**
+ * Polls an async operation until a completion condition is met.
+ * Backs off on 429 rate-limit responses (doubles interval, max 60s).
+ * Checks abort signal before each iteration.
+ */
+export declare function pollUntil<T>(fetchFn: () => Promise<T>, isDone: (result: T) => boolean, options: PollOptions<T>): Promise<T>;
+//# sourceMappingURL=polling.d.ts.map

package/dist/polling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.d.ts","sourceRoot":"","sources":["../src/polling.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,EAC9B,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,CAAC,CAAC,CAoDZ"}

package/dist/polling.js

@@ -0,0 +1,55 @@
+import { ApiError } from "./api-client.js";
+/**
+ * Polls an async operation until a completion condition is met.
+ * Backs off on 429 rate-limit responses (doubles interval, max 60s).
+ * Checks abort signal before each iteration.
+ */
+export async function pollUntil(fetchFn, isDone, options) {
+    const { timeoutMs, signal, onProgress } = options;
+    let intervalMs = options.intervalMs;
+    const deadline = Date.now() + timeoutMs;
+    let lastResult;
+    while (Date.now() < deadline) {
+        if (signal?.aborted) {
+            throw new Error("Operation cancelled");
+        }
+        try {
+            lastResult = await fetchFn();
+            // Reset interval after successful response
+            intervalMs = options.intervalMs;
+            if (onProgress) {
+                onProgress(lastResult);
+            }
+            if (isDone(lastResult)) {
+                return lastResult;
+            }
+        }
+        catch (error) {
+            if (error instanceof ApiError && error.status === 429) {
+                // Rate limited — double interval (max 60s)
+                intervalMs = Math.min(intervalMs * 2, 60_000);
+            }
+            else {
+                throw error;
+            }
+        }
+        // Wait before next poll, respecting abort signal
+        await new Promise((resolve, reject) => {
+            let onAbort;
+            const timer = setTimeout(() => {
+                if (onAbort && signal)
+                    signal.removeEventListener("abort", onAbort);
+                resolve();
+            }, intervalMs);
+            if (signal) {
+                onAbort = () => {
+                    clearTimeout(timer);
+                    reject(new Error("Operation cancelled"));
+                };
+                signal.addEventListener("abort", onAbort, { once: true });
+            }
+        });
+    }
+    throw new Error(`Operation timed out after ${timeoutMs / 1000}s. Last status: ${JSON.stringify(lastResult)}`);
+}
+//# sourceMappingURL=polling.js.map

package/dist/polling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.js","sourceRoot":"","sources":["../src/polling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAS3C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAAyB,EACzB,MAA8B,EAC9B,OAAuB;IAEvB,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAClD,IAAI,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,IAAI,UAAyB,CAAC;IAE9B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,OAAO,EAAE,CAAC;YAC7B,2CAA2C;YAC3C,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;YAEhC,IAAI,UAAU,EAAE,CAAC;gBACf,UAAU,CAAC,UAAU,CAAC,CAAC;YACzB,CAAC;YAED,IAAI,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;gBACvB,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACtD,2CAA2C;gBAC3C,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;YAChD,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,iDAAiD;QACjD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,IAAI,OAAiC,CAAC;YACtC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,OAAO,IAAI,MAAM;oBAAE,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACpE,OAAO,EAAE,CAAC;YACZ,CAAC,EAAE,UAAU,CAAC,CAAC;YACf,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,GAAG,GAAG,EAAE;oBACb,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;gBAC3C,CAAC,CAAC;gBACF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,KAAK,CACb,6BAA6B,SAAS,GAAG,IAAI,mBAAmB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAC7F,CAAC;AACJ,CAAC"}