Viper Redteam

viper-redteam

viper-redteam is a Claude Code plugin for authorized internal red team assessment and threat simulation through a remote Viper MCP server.

What This Plugin Adds

• a remote SSE MCP connection template for Viper
• three workflow skills for recon, session use, and MSF workflow
• three agents for multi-step operations, analysis, and reporting

Connection Model

This plugin connects Claude Code to a remote Viper MCP server over SSE.

• It does not package or launch Viper locally.
• It expects VIPER_MCP_SSE_URL to be set before Claude Code starts.
• The endpoint can use HTTP or HTTPS.

Example:

http://your_server_ip:8000/<uuid>/sse

MCP Configuration

The plugin reads the Viper SSE endpoint from plugins/viper-redteam/.mcp.json:

{
  "mcpServers": {
    "viper": {
      "type": "sse",
      "url": "${VIPER_MCP_SSE_URL}"
    }
  }
}

Set VIPER_MCP_SSE_URL before starting Claude Code.

Example:

bash

export VIPER_MCP_SSE_URL="http://your_server_ip:8000/<uuid>/sse"
claude

PowerShell

$env:VIPER_MCP_SSE_URL="http://your_server_ip:8000/<uuid>/sse"
claude

Notes:

• The value must be the full SSE endpoint, usually ending with /sse
• Changing the variable after Claude Code has already started usually will not affect the current session
• If the value changes, restart Claude Code and reconnect

Included Skills

• internal-recon — build the current host/session/route picture
• session-operations — inspect and use an existing session with minimal scope
• msf-workflow — follow the MSF module review and execution-readiness workflow

Included Agents

• redteam-operator — coordinate multi-step Viper tasks across hosts, sessions, routes, and evidence
• intelligence-analyst — interpret current environment state and suggest the next useful validation step
• engagement-reporter — generate structured assessment summaries and formal reporting

Quick Routing

• Need a current environment picture? Use internal-recon
• Need to inspect or use a session? Use session-operations
• Need MSF module review or execution readiness? Use msf-workflow
• Need a multi-step operational workflow? Use redteam-operator
• Need deeper analysis and prioritization? Use intelligence-analyst
• Need a structured report or handoff? Use engagement-reporter

Plugin Files

• .claude-plugin/plugin.json
• .mcp.json
• skills/
• agents/

Repository Guidance

For the full repository-level installation flow, marketplace structure, and repository guidance, use the root README.md.