# pentest-mcp-server

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1203 installs · ★ 1 repo stars
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/pentest-mcp-server
- Updated: 2026-10-17
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/pentest-mcp-server

## What it 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.

## Requirements
- Remote server: `https://pentest-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http pentest-mcp-server https://pentest-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add pentest-mcp-server --url https://pentest-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pentest-mcp-server": {
            "url": "https://pentest-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "pentest-mcp-server": {
            "type": "http",
            "url": "https://pentest-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http pentest-mcp-server https://pentest-mcp-server--cyanheads.run.tools
```

## When to use it
- 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
- Create an authorized `ssrf` testing plan by phase, with detection signals and mitigations.
- Inspect these HTTP response headers and body for leakage, fingerprints, and configuration issues.
- Map `linux`, `nginx`, and `jwt` to relevant ATT&CK techniques, then list the matching mitigations.

## Similar
- [web-pentest](https://affpapa.org/en/nevibecode/skills/web-pentest.md) — skill · 722 installs
- [pentest-toolkit-pro-html](https://affpapa.org/en/nevibecode/skills/pentest-toolkit-pro-html.md) — skill · 344 installs
- [security-pentest-planner](https://affpapa.org/en/nevibecode/skills/security-pentest-planner.md) — skill · 297 installs
- [engagement-planner](https://affpapa.org/en/nevibecode/agents/engagement-planner.md) — subagent · ★ 2482 repo stars
- [pentest-engagement](https://affpapa.org/en/nevibecode/skills/pentest-engagement.md) — skill · 157 installs
- [06-threat-hunting](https://affpapa.org/en/nevibecode/skills/06-threat-hunting.md) — skill · ★ 71 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
