Skip to content

io.github.cyanheads/pentest-mcp-server

by cyanheads · remote · local (npm) · no sign-in to list tools · v0.2.0 · published by GitHub user cyanheads

Offline methodology engine for authorized penetration testing, CTF, and security research.

Changes · 3
CompareRegistry entry

7 tools: 3 change things and 4 only read.

Scanned Oct 21, 2026

1 check matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http pentest https://pentest.caseyjhand.com/mcp

Findings

Matches of fixed checks, with the text they matched.

1 warn
  • Warnpentest_generate_payloads

    The server marks "pentest_generate_payloads" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"idempotentHint":true,"openWorldHint":false}; The name "pentest_generate_payloads" says "generate": a word for a change.

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

7 tools

Changes things 3Claude Code: ask
  • pentest_encode_payloadTransform a payload string through an ordered encoding chain for authorized filter research.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Transform a payload string through an ordered encoding chain for authorized filter research. Results include the final value, intermediate values, optional decode path and rationale, and detection guidance. All transforms are local; no live probing occurs.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
    • idempotentHint: true
  • pentest_generate_payloadsGenerate context-specific payload templates for authorized systems.1 finding

    Why it is in this group

    • The name "pentest_generate_payloads" says "generate": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "pentest_generate_payloads" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"idempotentHint":true,"openWorldHint":false}; The name "pentest_generate_payloads" says "generate": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Generate context-specific payload templates for authorized systems. Each template includes its vulnerability category, context rationale, WAF/IDS detection signature, mitigation, optional WAF research note, and optional encoded variant.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
    • idempotentHint: true
  • pentest_map_techniquesRank ATT&CK techniques and OWASP test cases against an authorized target profile of technology stack, exposed services, authentication type, and operating system.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Rank ATT&CK techniques and OWASP test cases against an authorized target profile of technology stack, exposed services, authentication type, and operating system. Results include profile-specific relevance, detection opportunities, mitigations, and associated methodology vectors.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
    • idempotentHint: true
Only reads 4Claude Code: allow
  • pentest_analyze_responseAnalyze an HTTP response from authorized probing for information leakage, fingerprinting signals, and related exposure.No findings

    Why it is in this group

    • The name "pentest_analyze_response" says "analyze": a word for reading.
    Description, as the server wrote it
    Analyze an HTTP response from authorized probing for information leakage, fingerprinting signals, and related exposure. Structured findings cover version disclosures, stack traces, debug headers, internal paths, authentication patterns, CORS configuration, detection signals, remediation, and associated methodology vectors.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
    • idempotentHint: true
  • pentest_get_guideReturn an authorized-testing methodology for a selected vector and optional target context.No findings

    Why it is in this group

    • The name "pentest_get_guide" says "get": a word for reading.
    Description, as the server wrote it
    Return an authorized-testing methodology for a selected vector and optional target context. The playbook covers reconnaissance, enumeration, exploitation, and post-exploitation phases with objectives, techniques, detection signals, mitigations, common pitfalls, references, and context-derived tool suggestions across 15 vectors.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
    • idempotentHint: true
  • pentest_lookup_groupLook up a MITRE ATT&CK threat group or software entry by ID, name, or keyword.No findings

    Why it is in this group

    • The name "pentest_lookup_group" says "lookup": a word for reading.
    Description, as the server wrote it
    Look up a MITRE ATT&CK threat group or software entry by ID, name, or keyword. Results include ATT&CK identity, aliases, type, description, and associated techniques with procedure-level context from public ATT&CK reporting.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
    • idempotentHint: true
  • pentest_lookup_techniqueLook up a MITRE ATT&CK technique by exact ID or keyword.No findings

    Why it is in this group

    • The name "pentest_lookup_technique" says "lookup": a word for reading.
    Description, as the server wrote it
    Look up a MITRE ATT&CK technique by exact ID or keyword. Results include tactics, platforms, description, detection data, public procedure examples, mitigations, related sub-techniques, and dataset version.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
    • idempotentHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.2.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http pentest https://pentest.caseyjhand.com/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__pentest__pentest_get_guide",
      "mcp__pentest__pentest_analyze_response",
      "mcp__pentest__pentest_lookup_technique",
      "mcp__pentest__pentest_lookup_group"
    ],
    "ask": [
      "mcp__pentest__pentest_map_techniques",
      "mcp__pentest__pentest_generate_payloads",
      "mcp__pentest__pentest_encode_payload"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as pentest. Review it before you use it.