pentest-mcp-server — Claude Code MCP server: use and install
An MCP server for authorized pentesting, CTF work, and security research. It builds test plans, maps ATT&CK techniques, inspects HTTP responses, and prepares payloads.
Apache-2.0 1,203 installs ★ 1 updated 2026-10-17
claude mcp add --transport http pentest-mcp-server https://pentest-mcp-server--cyanheads.run.toolsWhat pentest-mcp-server does
pentest-mcp-server is an offline methodology engine exposed through MCP. It supports authorized penetration testing, CTFs, and security research by building phased plans for attack vectors such as SSRF, XSS, SQL injection, and command injection. The server connects techniques to MITRE ATT&CK and the OWASP Testing Guide, then adds detection signals and mitigations. Other tools search ATT&CK techniques, groups, and software, or rank techniques for a target profile based on its stack, services, authentication type, and operating system.
It can inspect HTTP headers and bodies for leaks, technology fingerprints, and configuration issues. It also creates annotated payload templates for an injection context and applies ordered encoding chains with decode-path tracing. The supplied setup uses HTTP at https://pentest-mcp-server--cyanheads.run.tools. Testing systems without explicit written authorization is prohibited; the server cannot enforce your scope or permissions.
What it helps with
- build a phased plan for an attack vector
- map a target stack to relevant ATT&CK techniques
- inspect an HTTP response for leaks and fingerprints
- look up an ATT&CK technique, group, or software entry
- generate and encode a payload for an injection context
Example prompts for the agent
- Create an authorized
ssrftesting plan by phase, with detection signals and mitigations. - Inspect these HTTP response headers and body for leakage, fingerprints, and configuration issues.
- Map
linux,nginx, andjwtto relevant ATT&CK techniques, then list the matching mitigations.
How to install pentest-mcp-server
Platform CLI: remote server
claude mcp add --transport http pentest-mcp-server https://pentest-mcp-server--cyanheads.run.toolsPlatform CLI: remote server
codex mcp add pentest-mcp-server --url https://pentest-mcp-server--cyanheads.run.toolsConfig file
{
"mcpServers": {
"pentest-mcp-server": {
"url": "https://pentest-mcp-server--cyanheads.run.tools"
}
}
}Config file
{
"servers": {
"pentest-mcp-server": {
"type": "http",
"url": "https://pentest-mcp-server--cyanheads.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http pentest-mcp-server https://pentest-mcp-server--cyanheads.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about pentest-mcp-server
How do I install pentest-mcp-server in Claude Code?
Run claude mcp add --transport http pentest-mcp-server https://pentest-mcp-server--cyanheads.run.tools.
What does pentest-mcp-server do?
It gives an agent authorized pentesting playbooks, ATT&CK lookups, HTTP response analysis, target-specific technique mapping, and payload generation. Results include detection context and mitigation guidance.
Which platforms support pentest-mcp-server?
It is listed for Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, and Gemini CLI. The provided Claude Code setup connects to it over HTTP.