Skip to content

CheckView MCP Server (Claude Code & Cursor)


The CheckView MCP server lets you manage your tests directly from AI assistants like Claude Code and Cursor. You can create test flows, trigger runs, and read results in plain language, without leaving your editor.

CheckView MCP server connected in Claude Code

Before you start

You will need a CheckView Personal Access Token:

  • In the CheckView dashboard, go to Organization Settings → API Tokens.
  • Click Create token, give it a name (for example “Claude Code”), and copy the cvpat_ value. You will not be able to see it again.

Add it to Claude Code

Run this command, using your token:

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

Then start Claude Code and try a prompt like “List my CheckView websites”.

Add it to Cursor

Open Settings → MCP → Add new server and paste:

{
  "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"
      }
    }
  }
}

Add it to Windsurf

Windsurf uses the same MCP configuration format as Cursor. Open Windsurf’s MCP settings, add a new server, and paste the same block:

{
  "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"
      }
    }
  }
}

What you can do

  • Create form and WooCommerce checkout test flows
  • Run tests and read pass or fail results, screenshots, and AI failure summaries
  • Manage websites, schedules, and team members
  • Generate and read UX audit reports
  • Check your monthly test usage

Example prompts

Once the server is connected, try prompts like these:

  • “Show me all my websites and their current status”
  • “Run all tests on example.com”
  • “What were the results of my last test run?”
  • “Create a new test flow for the contact form on example.com”
  • “Show me test runs that failed this week”
  • “Get an AI summary of test run #456”
  • “Pause testing on my staging site”
  • “What’s my organization’s usage this month?”

Notes

  • Requires Node.js 18 or newer on your machine. npx downloads and runs the server automatically.
  • Your token carries your account’s permissions, so treat it like a password. You can revoke it any time from Organization Settings → API Tokens.
  • The server is published on npm as @checkview/mcp-server.