Skip to content
MCP server

Webscope

Token-light testing of web apps: database queries, browser screens and code lookups

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.6.0
Listing updated
today

Similar MCP servers

About Webscope

Webscope is a free MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Webscope exists because the costly part of asking an agent to test a screen is reading, not thinking: whole HTML pages, hundreds of table rows, grep output. It replaces that with short, capped, structured answers so a full round of looking at a screen, filling it, saving and seeing what was stored takes a handful of calls. It is a single Go binary with four tools, query, page, check and code, and the README says it never writes to your database.

query runs one read-only SQL statement against MySQL or SQLite. page drives a tab in your Chrome through the Claude in Chrome extension: it can fill forms, read the requests sent, force an HTTP error and audit a screen. check compares what a screen sent, what the database stored and what the screen read back. code reads the project's source, including Laravel routes, Vue modules and legacy PHP.

Answers are capped at 50 rows by default, 200 characters per cell and 8,000 bytes. Writes only happen through the screen, on test rows prefixed ZZ_. The package is also listed on PyPI as webscope-mcp.

Install

Run in a terminal

claude mcp add webscope -- uvx webscope-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "webscope": {
      "command": "uvx",
      "args": [
        "webscope-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "webscope": {
      "command": "uvx",
      "args": [
        "webscope-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "webscope": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "webscope-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "webscope": {
      "command": "uvx",
      "args": [
        "webscope-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "webscope": {
      "command": "uvx",
      "args": [
        "webscope-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

query
Runs one read-only SQL statement and returns a short table.
page
Reads, fills and clicks a screen in Chrome and inspects its requests.
check
Compares what a screen sent, what the database stored and what the screen read back.
code
Looks up tables, columns, routes, flows and test cases in the source code.

What it does

Read-only SQL
Runs one statement at a time with a statement check and a read-only session.
Browser screen control
Reads, fills and clicks a screen in your Chrome and reports the requests it sent.
Save verification
Compares what was sent, stored and read back, showing only differences.
Code lookups
Finds who uses a column, which endpoint a screen calls and what an action wrote.
Old versus new screens
Compares requests and fields between a legacy and a rewritten screen.
Capped answers
Limits rows, cell length and answer size to save tokens.

Good for

  • Test a form end to end and confirm what was stored
  • Find which backend code reads a database column
  • Check that a rewritten screen sends the same fields as the old one
  • Simulate a 500 error to see how a screen reacts
  • Audit a screen for unrendered text or covered controls

Pricing

Free

Free; no pricing listed

Webscope FAQ

Does it write to the database?

No. The query tool is read-only, and writes happen only through the screen on ZZ_ test rows.

What does it need to start?

Only WEBSCOPE_DB_URL for query; other variables switch on page and code.

Which browser is needed?

Google Chrome with the Claude in Chrome extension for page and check.

Which stacks does it support?

Any web app and MySQL or SQLite database; some code tools target Laravel, Vue and legacy PHP.

Is Webscope free?

Yes. Webscope is free to use.

How do I add Webscope to Claude Code?

Run this command in your terminal: claude mcp add webscope -- uvx webscope-mcp

What are the best alternatives to Webscope?

The closest alternatives to Webscope are REA, Browser Use, Scrapling MCP Server, Context7 and Chrome DevTools MCP.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers