mcpField
W
WhatWeb MCP

WhatWeb MCP

Local
devkind.com.auSecurity2Updated 4d ago

About WhatWeb MCP

WhatWeb MCP connects AI agents and other MCP clients to WhatWeb for website technology fingerprinting. It returns structured scan reports and includes tools for retrieving past results and checking active scans.

Key features

  1. 01Identify CMS, servers, frameworks, and analytics
  2. 02Scan at five aggression levels
  3. 03Retrieve previous scan results by ID
  4. 04List active scans
  5. 05Sandboxed Docker execution

Use cases

  1. 01Qualify sales leads by website technology
  2. 02Perform authorized security reconnaissance

MCP support

Exposes `whatweb_scan`, `get_scan_results`, and `list_active_scans` to MCP clients. The Python server uses stdio and runs WhatWeb in a Docker container.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"devkindhq-whatweb": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"WHATWEB_TIMEOUT",
"-e",
"WHATWEB_MAX_CONCURRENT",
"docker.io/devkind/whatweb-mcp:1.0.0"
],
"env": {
"WHATWEB_TIMEOUT": "<WHATWEB_TIMEOUT>",
"WHATWEB_MAX_CONCURRENT": "<WHATWEB_MAX_CONCURRENT>"
}
}
}
}
Run commanddocker run -i --rm -e WHATWEB_TIMEOUT -e WHATWEB_MAX_CONCURRENT docker.io/devkind/whatweb-mcp:1.0.0
Environment variables to set
WHATWEB_TIMEOUTPer-scan timeout in seconds (default 300)
WHATWEB_MAX_CONCURRENTMaximum concurrent scans (default 2)

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocidocker.io/devkind/whatweb-mcp:1.0.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

WhatWeb MCP Server: web technology fingerprinting for AI agents

WhatWeb MCP server lets Claude Code, Cursor, and any MCP client fingerprint websites and identify their CMS, web server, frameworks, and analytics tools. It runs WhatWeb in a hardened Docker container and returns a structured report in one tool call.

Sales and prospecting teams use it to qualify leads; security teams use it for recon.

The server publishes three tools: whatweb_scan (scan a target at five aggression levels), get_scan_results (fetch a previous scan by ID), and list_active_scans (see what is running). Scans run in a sandboxed container with a non-root user, memory and CPU limits, and flag-injection validation on every target.

Quickstart (Docker)

The image is multi-arch (linux/amd64 and linux/arm64), so the same tag works on Apple Silicon, x86 servers, and ARM cloud instances.

docker pull devkind/whatweb-mcp:latest

Ready-paste config for Claude Code or Cursor, saved as .mcp.json in your project root (or ~/.cursor/mcp.json):

{
  "mcpServers": {
    "whatweb": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--memory=512m", "--cpus=0.5", "--pids-limit=100", "devkind/whatweb-mcp:latest"]
    }
  }
}

Then ask your agent: "What technologies does example.com run?"

Install in your client

Requirements:

  • Docker
  • Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, or any other MCP client
  • No API keys

Standard config works in most MCP clients:

{
  "mcpServers": {
    "whatweb": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--memory=512m",
        "--cpus=0.5",
        "--pids-limit=100",
        "devkind/whatweb-mcp:latest"
      ]
    }
  }
}
Claude Desktop

Follow the MCP install guide and add the standard config above to your claude_desktop_config.json.

Claude Code

Run:

claude mcp add whatweb -- docker run -i --rm --memory=512m --cpus=0.5 --pids-limit=100 devkind/whatweb-mcp:latest

Or add the standard config above to .mcp.json in your project root.

Cursor
Click the button to install:

Install in Cursor

Or install manually:

Go to Cursor Settings -> MCP -> Add new MCP Server. Name it "WhatWeb MCP", use command type with the command docker run -i --rm --memory=512m --cpus=0.5 --pids-limit=100 devkind/whatweb-mcp:latest.

VS Code

Follow the MCP install guide and use the standard config above. You can also install with the VS Code CLI:

code --add-mcp '{"name":"whatweb","command":"docker","args":["run","-i","--rm","--memory=512m","--cpus=0.5","--pids-limit=100","devkind/whatweb-mcp:latest"]}'
Windsurf

Follow the Windsurf MCP documentation and use the standard config above.

Goose

Go to Advanced settings -> Extensions -> Add custom extension. Name it "WhatWeb MCP", use type STDIO, and set the command to docker run -i --rm --memory=512m --cpus=0.5 --pids-limit=100 devkind/whatweb-mcp:latest. Click "Add Extension".

LM Studio

Go to Program in the right sidebar -> Install -> Edit mcp.json. Use the standard config above.

Warp

Go to Settings -> AI -> Manage MCP Servers -> + Add to add an MCP Server. Use the standard config above, or use the slash command /add-mcp in the Warp prompt and paste it.

Example tool call and output

{ "tool": "whatweb_scan", "arguments": { "target": "https://example.com", "aggression": "normal" } }
{
  "scan_id": "a1b2c3d4",
  "target": "https://example.com",
  "status": "completed",
  "http_status": 200,
  "stats": { "total_technologies": 3 },
  "technologies": [
    { "name": "nginx", "version": "1.25.3", "string": null },
    { "name": "WordPress", "version": "6.4.3", "string": "wp-content" },
    { "name": "jQuery", "version": "3.7.1", "string": "jquery.js" }
  ],
  "error": null
}

Aggression levels map to WhatWeb's -a flag: stealthy/passive (1, one request), polite (2), normal (3), aggressive (4, potentially intrusive, so use only on targets you are authorized to test).

How it works

The container installs WhatWeb from the official upstream repository on an Alpine Ruby base, then runs a Python MCP server (mcp SDK, stdio transport). Each scan shells out with an argument array (no shell interpolation), writes WhatWeb's JSON log to an ephemeral /app/output, and parses it into typed results. Up to 100 scan results are kept in memory for follow-up questions in the same session. Tests cover target validation, JSON parsing, result-store bounds, and a live MCP stdio JSON-RPC handshake. Run them with pytest. Also installable from source without Docker: pip install -r requirements.txt && python3 server.py (requires WhatWeb on your PATH).

Roadmap

  • Official MCP Registry listing (io.github.devkindhq/whatweb-mcp)
  • Docker MCP Registry and Smithery listings
  • Batch scanning (multiple targets in one call)
  • Optional CSV/JSON export tool
  • Scheduled re-scans with diffing (alert when a target's stack changes)

Built by

Built by Devkind. Maintained by Kazim Ali.

License

MIT. See CONTRIBUTING.md and SECURITY.md. WhatWeb itself is licensed by its upstream authors. Scan only targets you are authorized to scan.

Qualifying leads by their tech stack?

Once you know what a site runs, Devkind can help you build on it. We work with Shopify, Swell and headless commerce stacks, and build custom MCP servers and AI agent workflows. Talk to Devkind or email [email protected].

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.