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
- 01Identify CMS, servers, frameworks, and analytics
- 02Scan at five aggression levels
- 03Retrieve previous scan results by ID
- 04List active scans
- 05Sandboxed Docker execution
Use cases
- 01Qualify sales leads by website technology
- 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.
docker run -i --rm -e WHATWEB_TIMEOUT -e WHATWEB_MAX_CONCURRENT docker.io/devkind/whatweb-mcp:1.0.0WHATWEB_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.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEWhatWeb 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:
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
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.