Skip to main content
Glama
ViperClaw MCP Server

ViperClaw MCP Server


⚑ Why ViperClaw?

Most automated AppSec wrappers fail in production: dumping 150+ noisy CLI scanners into an LLM causes context-window rot and noisy alerts, while monolithic container stacks require 4–6 services and separate API budgets when you already run a frontier coding agent locally.

ViperClaw pairs 64 compliance & code-review playbooks with 10 zero-dependency Python 3.10+ verification engines and a strict "Evidence-First" Quality Gate:

Core Subsystem

Capability & Implementation

πŸ•ΈοΈ Stigmergic Graph

Zero-setup SQLite knowledge graph with priority scoring, decay & Mermaid topology export.

🌐 BrowserOS & Posture Inspector

Bridges signed-in BrowserOS Neo tabs (fetch/XHR inspection, JWT claims, storage hygiene) + non-destructive HTTP/CORS/OpenAPI posture checks.

⚑ Barrier Concurrency Engine

Pre-connected socket pool synchronized via threading.Barrier to verify TOCTOU DB locking & idempotency controls.

πŸ”‘ JWT & GraphQL Auditors

RFC 8725 JWT claim verification, weak HMAC entropy checks (alg:none / kid / RS256β†’HS256), plus GraphQL schema & batching audits.

πŸ“‘ OOB & JS Harvester

HMAC-tagged OOB egress verification canaries + ephemeral callback listener, plus Webpack / Vite / Next.js lazy-chunk inventory.

πŸ”¬ Taint SAST & Oracle

Multi-hop taint SAST (Python, TS/JS, Go, PHP) + 7-Gate Evidence Verifier (WAF Soft-200 filter, authorization diff, CVSS 3.1, SARIF 2.1.0).


Related MCP server: bug-bounty-hunter

πŸš€ Quickstart

πŸ“˜ New to ViperClaw? Read the complete step-by-step Beginner-to-Pro User Guide (docs/README.md).

# 1. Clone & install (<2 seconds, zero external dependencies, Python 3.10+)
git clone https://github.com/zahidoverflow/viperclaw.git
cd viperclaw
pip install -e .

# 2. Install all ViperClaw skills into Antigravity, Claude Code, Codex & Cursor
viperclaw skills install --target all

# 3. Auto-register the Phase-Gated MCP server (e.g. Antigravity ~/.gemini/config/mcp_config.json)
viperclaw mcp install --target antigravity

Run viperclaw mcp install --target all (or claude mcp add viperclaw -- viperclaw mcp), or add manually to your harness mcp_config.json / .mcp.json:

{
  "mcpServers": {
    "viperclaw": {
      "command": "viperclaw",
      "args": ["mcp"]
    }
  }
}
  • Single-Harness Skill Install: Use --target antigravity, --target claude, --target codex, or --target cursor.

  • Claude Code Plugin Marketplace: Run /plugin marketplace add zahidoverflow/viperclaw then /plugin install viperclaw@viperclaw.

GitHub Actions (.github/workflows/security.yml):

- name: Run ViperClaw Security Audit
  uses: zahidoverflow/viperclaw@main
  with:
    path: "."
    mode: "taint"

Pre-Commit (.pre-commit-config.yaml):

repos:
  - repo: https://github.com/zahidoverflow/viperclaw
    rev: v2.0.0
    hooks:
      - id: viperclaw-taint
      - id: viperclaw-harvest-js

🧬 Architecture


πŸ’» CLI & MCP Reference

Both viperclaw and the shorthand vclaw alias provide standalone CLI subcommands as well as the JSON-RPC 2.0 stdio MCP bridge:

CLI&nbsp;Command

Purpose &amp; Key Flags

viperclaw&nbsp;scan&nbsp;&lt;url&gt;

Stateful live HTTP web scanner &amp; wire-verified exploit runner (--db, --report-md, --report-sarif).

viperclaw&nbsp;race&nbsp;&lt;url&gt;

Barrier-synchronized concurrent socket burst for TOCTOU race conditions (-c 20, -d, --cookie, --auth).

viperclaw&nbsp;jwt&nbsp;&lt;token&gt;

Decode JWT, crack HMAC secrets, forge alg:none / kid / RS256β†’HS256 tokens &amp; replay (--target-url).

viperclaw&nbsp;graphql&nbsp;&lt;url&gt;

Audit GraphQL for introspection bypass, Clairvoyance field suggestions &amp; query batching (--auth, --cookie).

viperclaw&nbsp;oob

Generate HMAC-authenticated blind OOB exploit payloads (SSRF, XXE, CMDi, SSTI, SQLi, JNDI) (--callback).

viperclaw&nbsp;browser

Output BrowserOS Neo JS runtime hooks (--scripts) or ingest a live browser DOM/storage snapshot (--ingest).

viperclaw&nbsp;taint&nbsp;&lt;path&gt;

Multi-language source-to-sink taint SAST for Python, TS/JS, Go &amp; PHP (--db, --output).

viperclaw&nbsp;harvest&#8209;js&nbsp;&lt;path&gt;

Webpack / Vite / Next.js lazy-chunk, hidden endpoint &amp; secret harvester (--base-url, --db, --output).

viperclaw&nbsp;fingerprint&nbsp;&lt;har&gt;

Caido / Burp .har backend framework &amp; sibling API fingerprinter (--domain, --output).

viperclaw&nbsp;graph

Query top pheromone-ranked attack leads &amp; export Mermaid topology (--db, --top-leads, --mermaid).

viperclaw&nbsp;verify&nbsp;[file]

Run the 7-Question Triage Gate, CVSS 3.1 calculator &amp; H1 MD / SARIF exporter (--report-md, --report-sarif).

# 1. Run a stateful live web scan & export verified HackerOne Markdown + SARIF 2.1.0
viperclaw scan http://127.0.0.1:4280 --db .viperclaw/graph.db --report-md bounty_report.md --report-sarif findings.sarif

# 2. Fire a 20-worker barrier-synchronized TOCTOU race burst against a coupon/transfer endpoint
viperclaw race https://api.target.tld/v1/coupon/redeem -X POST -d "code=VIPER2026" --cookie "session=abc" -c 20

# 3. Crack a JWT's HMAC secret, synthesize forged admin tokens & replay against a live endpoint
viperclaw jwt "eyJhbGciOiJIUzI1NiIs..." --target-url https://api.target.tld/v1/admin

# 4. Scan a GraphQL endpoint for introspection bypass, Clairvoyance field leaks & batching
viperclaw graphql https://api.target.tld/graphql --auth "Bearer eyJ..."

# 5. Audit source code for multi-hop taint flows & reconstruct SPA lazy chunks
viperclaw taint ./target-repo --db .viperclaw/graph.db --output taint_flows.json
viperclaw harvest-js ./bundles --base-url https://app.target.tld/ --db .viperclaw/graph.db

MCP&nbsp;Tool

Phase

Description

viper_live_scan

Posture

Run non-destructive HTTP/CORS/header inspection, public API schema discovery, and authorized lab verification.

viper_race_burst

Verify

Verify database locking, idempotency keys, and TOCTOU concurrency controls under synchronized HTTP requests.

viper_jwt_audit

Audit

Audit JWT claims against RFC 8725, verify HMAC secret entropy, and check signature enforcement edge cases.

viper_graphql_scan

Audit

Audit GraphQL for schema introspection exposure, field suggestion hints, array batching &amp; authorization controls.

viper_oob_probe

Verify

Generate HMAC-tagged Out-of-Band (OOB) egress verification canaries and verify callback handling.

viper_browser_ingest

BrowserOS

Output BrowserOS Neo JS runtime telemetry hooks (fetch/XHR/storage) or ingest browser snapshots into the Graph.

viper_taint_scan

SAST

Run multi-language source-to-sink taint analysis across Python, TypeScript/JavaScript, Go, and PHP.

viper_harvest_js

Inventory

Reconstruct Webpack/Vite/Next.js lazy chunks and inventory endpoints, authorization candidates, GraphQL ops &amp; secrets.

viper_fingerprint_traffic

Inventory

Fingerprint backend frameworks, CDN/WAF banners, CORS posture, and error envelopes from .har captures or URLs.

viper_graph_upsert

Graph

Upsert hosts, endpoints, lazy chunks, taint sinks, or findings into the Stigmergic SQLite Assessment Graph.

viper_graph_leads

Graph

Query top pheromone-ranked review leads and export a live Mermaid topology diagram.

viper_diff_oracle

Verify

Compare baseline vs. probe HTTP responses to verify authorization boundaries and filter WAF Soft-200 blocks.

viper_verify_and_report

Report

Run the 7-Question Triage Gate, calculate exact CVSS v3.1 scores, and generate Markdown + SARIF 2.1.0 reports.


🎯 Security Audit Playbooks (64 Skills + /viperclaw)

Each skill in skills/ encodes a senior security engineer's checklist, architecture diagram, and hardened remediation patterns:

  • 🧭 Orchestration & QA: /viperclaw (Master entrypoint), viper&#8209;orchestrator (5-Phase Architecture Audit router), and viper&#8209;proof&#8209;judge (7-Gate Evidence Quality &amp; CVSS 3.1 verifier).

  • 🌐 BrowserOS Session & Edge Alignment: viper&#8209;browseros&#8209;agent (BrowserOS Neo DOM &amp; storage audit) and viper&#8209;proxy&#8209;parser&#8209;alignment (reverse-proxy vs. backend parser consistency checks).

  • πŸ”­ Code Inventory & White-Box SAST: viper&#8209;js&#8209;harvester (SPA lazy chunks), viper&#8209;proxy&#8209;fingerprint (HAR stack profiling), and viper&#8209;taint&#8209;sast (Polyglot taint auditing).

  • πŸ›‘οΈ Web, API & Cloud Auditing: viper&#8209;bola&#8209;idor, viper&#8209;injection&#8209;oracle, viper&#8209;ssrf&#8209;cloud, viper&#8209;auth&#8209;oauth&#8209;jwt, viper&#8209;graphql&#8209;ws, and viper&#8209;race&#8209;logic.

  • πŸ€– AI & MCP Guardrails: viper&#8209;ai&#8209;llm&#8209;guardrails (Prompt boundaries, MCP authorization &amp; RAG isolation).

#

Skill&nbsp;Playbook

Security Audit &amp; Remediation Focus

01

viper&#8209;ai&#8209;llm&#8209;guardrails

AI, LLM & MCP Application Security & Guardrails Auditor (OWASP LLM Top 10).

02

viper&#8209;auth&#8209;oauth&#8209;jwt

Authentication, OAuth 2.0 / OIDC & JWT Security Auditor.

03

viper&#8209;aws&#8209;iam&#8209;cloud&#8209;audit

AWS IAM, STS, S3, KMS & Lambda Security Auditor (modeled on Prowler, Parliament & CloudSplaining).

04

viper&#8209;bola&#8209;idor

Object & Function-Level Authorization (BOLA / BFLA) Audit Skill.

05

viper&#8209;browser&#8209;extension&#8209;mv3

Chrome/Firefox Browser Extension (Manifest V3) Security Auditor.

06

viper&#8209;browseros&#8209;agent

BrowserOS Neo Live Application Inspection & DOM Security Audit Skill.

07

viper&#8209;cicd&#8209;hardening

CI/CD Pipeline & GitHub Actions Security Auditor (modeled on Zizmor, Actionlint & StepSecurity).

08

viper&#8209;container&#8209;k8s&#8209;audit

Docker Container & Kubernetes Manifest Security Auditor (modeled on Trivy, Kubescape & CIS Benchmarks).

09

viper&#8209;crypto&#8209;tls&#8209;audit

Cryptography, Key Management & Password Hashing Auditor (modeled on Trail of Bits & OWASP Cryptographic Storage).

10

viper&#8209;csrf&#8209;samesite&#8209;audit

Cross-Site Request Forgery (CSRF) Defense & State-Change Auditor (OWASP ASVS V4).

11

viper&#8209;dependency&#8209;sbom

Software Supply Chain, Lockfile Integrity & Dependency Vulnerability Auditor (modeled on OSV-Scanner, Pip-Audit & Dependabot).

12

viper&#8209;deserialization&#8209;parser

Safe Deserialization & XML/YAML/JSON Parser Auditor (OWASP Deserialization Cheat Sheet).

13

viper&#8209;dns&#8209;email&#8209;domain

DNS, Subdomain Takeover, SPF/DKIM/DMARC & Email Security Auditor.

14

viper&#8209;electron&#8209;tauri&#8209;desktop

Electron & Tauri Desktop Application Security Auditor (modeled on Electronegativity & Doyensec checklists).

15

viper&#8209;fastapi&#8209;django&#8209;flask

Python Web Framework Security Auditor (FastAPI, Django, Flask).

16

viper&#8209;file&#8209;upload&#8209;storage

File Upload, Path Traversal & Object Storage Security Auditor (OWASP File Upload Cheat Sheet).

17

viper&#8209;gcp&#8209;azure&#8209;cloud&#8209;audit

Google Cloud (GCP) & Microsoft Azure Security Posture Auditor (modeled on ScoutSuite & Prowler).

18

viper&#8209;github&#8209;repo&#8209;governance

GitHub Organization, Branch Protection & OpenSSF Scorecard Auditor.

19

viper&#8209;go&#8209;service&#8209;audit

Go (Golang) Microservice & Concurrency Security Auditor (modeled on Trail of Bits Go & gosec).

20

viper&#8209;graphql&#8209;ws

GraphQL Schema & WebSocket Security Auditor.

21

viper&#8209;grpc&#8209;protobuf&#8209;audit

gRPC, Protobuf & Internal RPC Security Auditor.

22

viper&#8209;headers&#8209;csp&#8209;cors

HTTP Security Headers, Content-Security-Policy (CSP) & CORS Configuration Auditor (modeled on Mozilla Observatory & OWASP Secure Headers).

23

viper&#8209;iac&#8209;terraform&#8209;audit

Infrastructure-as-Code (Terraform, CloudFormation & Pulumi) Security Auditor (modeled on Checkov & tfsec).

24

viper&#8209;injection&#8209;oracle

Input Validation & Query Parameterization Auditor.

25

viper&#8209;java&#8209;spring&#8209;audit

Java, Spring Boot & Spring Security Auditor (modeled on FindSecBugs & Semgrep Java).

26

viper&#8209;js&#8209;harvester

Client-Side Bundle & SPA Manifest Auditor.

27

viper&#8209;kafka&#8209;rabbitmq&#8209;queue

Event Streaming & Message Queue Security Auditor (Kafka, RabbitMQ, Celery, BullMQ, SQS).

28

viper&#8209;linux&#8209;systemd&#8209;host

Linux Host, Systemd Unit, SUID & Seccomp Hardening Auditor (modeled on Lynis & CIS Linux Benchmarks).

29

viper&#8209;logging&#8209;pii&#8209;compliance

Security Logging, PII Redaction & Error Sanitization Auditor (OWASP Logging Cheat Sheet & ASVS V7).

30

viper&#8209;mcp&#8209;server&#8209;audit

Model Context Protocol (MCP) Server & Agentic Tool Security Auditor (OWASP MCP Top 10).

31

viper&#8209;mobile&#8209;api&#8209;config

Mobile App Static Configuration & API Security Auditor (modeled on OWASP MASVS & MobSF).

32

viper&#8209;multitenant&#8209;isolation

Multi-Tenant SaaS Data Isolation & Row-Level Security (RLS) Auditor.

33

viper&#8209;nextjs&#8209;react&#8209;rsc

Next.js App Router, React Server Components &amp; Server Actions Auditor.

34

viper&#8209;nginx&#8209;envoy&#8209;gateway

Nginx, Envoy, Traefik & API Gateway Security Auditor (modeled on Gixy & OWASP Reverse Proxy).

35

viper&#8209;nodejs&#8209;express&#8209;nestjs

Node.js, Express, NestJS &amp; Fastify Security Auditor.

36

viper&#8209;oauth&#8209;oidc&#8209;compliance

OAuth 2.1, OIDC &amp; SSO Protocol Compliance Auditor (RFC 9700).

37

viper&#8209;openapi&#8209;rest&#8209;schema

OpenAPI / Swagger Schema, Mass Assignment & REST API Security Auditor (OWASP API3 & API4).

38

viper&#8209;orchestrator

Master 5-Phase Security Audit & Architecture Review Orchestrator.

39

viper&#8209;payment&#8209;stripe&#8209;pci

Payment Processing, Stripe/PayPal Ledger & Financial Precision Auditor.

40

viper&#8209;php&#8209;laravel&#8209;wordpress

PHP, Laravel & WordPress Security Auditor.

41

viper&#8209;postgres&#8209;redis&#8209;mongo

Database & Cache Security Auditor (PostgreSQL, Redis, MongoDB).

42

viper&#8209;privacy&#8209;gdpr&#8209;hipaa

Privacy Engineering, GDPR / HIPAA Data Flow & PII Minimization Auditor.

43

viper&#8209;proof&#8209;judge

Evidence Quality Gate, CVSS v3.1 Calculator &amp; Security Report Writer.

44

viper&#8209;proxy&#8209;fingerprint

HTTP Stack, Header & Error-Envelope Auditor.

45

viper&#8209;race&#8209;logic

Concurrency, Idempotency & Business Logic Auditor.

46

viper&#8209;rag&#8209;vector&#8209;audit

RAG Pipeline, Embedding & Vector Database Security Auditor.

47

viper&#8209;rate&#8209;limit&#8209;dos&#8209;resilience

Application Rate Limiting, ReDoS & Resource Exhaustion Auditor (OWASP API4:2023).

48

viper&#8209;remediation&#8209;patch&#8209;verifier

Security Patch Synthesizer & Regression Test Generator.

49

viper&#8209;ruby&#8209;rails&#8209;audit

Ruby on Rails & Rack Security Auditor (modeled on Brakeman).

50

viper&#8209;rust&#8209;memory&#8209;unsafe

Rust 'unsafe', FFI, Async & Integer Safety Auditor (modeled on RustSec, Rudra & Clippy security lints).

51

viper&#8209;saml&#8209;sso&#8209;enterprise

Enterprise SAML 2.0, SCIM &amp; XML Signature Wrapping Auditor.

52

viper&#8209;sbom&#8209;slsa&#8209;provenance

SLSA Build Provenance, Sigstore Cosign & Artifact Integrity Auditor.

53

viper&#8209;secrets&#8209;audit

Hardcoded Secret, Credential Entropy & Git History Leak Auditor (modeled on Gitleaks & TruffleHog).

54

viper&#8209;session&#8209;cookie&#8209;audit

Session Lifecycle, Cookie Hardening & Token Invalidation Auditor (OWASP ASVS V3).

55

viper&#8209;smart&#8209;contract&#8209;review

Smart Contract Static Security Auditor (modeled on Slither, Trail of Bits & OpenZeppelin checklists).

56

viper&#8209;solidity&#8209;defi&#8209;advanced

Advanced DeFi Protocol, Oracle, EIP-712 & Cross-Chain Bridge Auditor (modeled on Trail of Bits, Cyfrin & Immunefi).

57

viper&#8209;ssrf&#8209;cloud

Outbound Request (SSRF) & Cloud Egress Auditor.

58

viper&#8209;taint&#8209;sast

White-Box Multi-Language Source-to-Sink Taint Analysis Skill.

59

viper&#8209;threat&#8209;model&#8209;stride

STRIDE Threat Modeling, Data Flow Diagram (DFD) & Trust Boundary Architect (modeled on OWASP Threat Modeling & Trail of Bits).

60

viper&#8209;proxy&#8209;parser&#8209;alignment

Reverse-Proxy, Edge Filter & Backend Parser Alignment Auditor.

61

viper&#8209;wasm&#8209;c&#8209;cpp&#8209;memory

C, C++, JNI & WebAssembly Memory Safety Auditor (modeled on Trail of Bits C/C++ & Flawfinder).

62

viper&#8209;webauthn&#8209;passkey&#8209;mfa

WebAuthn, FIDO2 Passkey & TOTP MFA Security Auditor.

63

viper&#8209;webhook&#8209;edr&#8209;hmac

Inbound & Outbound Webhook Security Auditor.

64

viper&#8209;zero&#8209;trust&#8209;mtls&#8209;mesh

Zero-Trust Service Mesh, Istio/Linkerd mTLS & SPIFFE/SPIRE Auditor.


πŸ† Benchmarks & Comparison

ViperClaw is continuously validated against Damn Vulnerable Web Application (DVWA) and synthetic TOCTOU/JWT/GraphQL/OOB labs across both static source auditing and live wire exploitation:

  • White-Box Taint SAST (viperclaw taint): 19 / 19 (100%) vulnerable modules detected via transitive taint tracking, with 0 False Positives on hardened impossible.php targets (PDO::prepare, intval, is_numeric, in_array, htmlspecialchars).

  • Black-Box Live Exploitation (viperclaw scan + race + jwt + graphql + oob): 14 / 14 (100%) DVWA modules plus barrier-synchronized TOCTOU race windows, HMAC JWT cracking, GraphQL Clairvoyance, and OOB callbacks verified over the wire.

#

Severity

Vulnerability&nbsp;Module

Verified Wire Proof / Exploit Vector

01

HIGH (8.8)

OS Command Injection

ip=127.0.0.1;id β†’ Verified uid=33(www-data) execution

02

HIGH (8.1)

UNION SQL Injection

' UNION SELECT user,password FROM users# β†’ Credential hash dump

03

MED (6.5)

Boolean Blind SQLi

True (1' AND 1=1#) vs. False (1' AND 1=2#) differential oracle

04

HIGH (8.1)

SQLi Auth Bypass

username=admin' OR '1'='1' LIMIT 1# β†’ Authenticated admin session

05

HIGH (7.1)

Local File Inclusion

?page=/etc/passwd β†’ Verified root:x:0:0:root:/root:/bin/bash

06

CRIT (9.9)

Unrestricted Upload RCE

Multipart PHP upload β†’ Verified RCE at /hackable/uploads/viperclaw_poc.php

07

MED (6.1)

Reflected XSS

Unescaped HTML payload reflection verified in DOM response

08

MED (5.4)

Stored XSS (Guestbook)

Persistent payload stored in mtxMessage and rendered to viewers

09

HIGH (8.2)

Predictable Session ID

Sequential dvwaSession $+1$ increment proven across consecutive requests

10

HIGH (8.8)

CSRF Password Reset

State-changing GET password reset verified without anti-CSRF token

11

MED (6.5)

CAPTCHA Workflow Bypass

Direct step=2 state-machine jump verified via auth oracle &amp; restored

12

MED (5.4)

CSP Bypass &amp; Injection

External script injection via permissive Content-Security-Policy &amp; include

13

MED (6.5)

JS Token Reversal

Reversed md5(rot13("success")) client-side token &amp; verified acceptance

14

MED (6.1)

DOM-Based XSS

Unescaped location.href sink into document.write() verified in browser

Capability / Architecture

🐍 ViperClaw v2.0

Strix / Shannon

PentAGI / RedAmon

HexStrike AI

Vulnhuntr

Architecture Pattern

64 Skills + 13 MCP + Engine

Containerized Agent

Docker + Neo4j Stack

150-Tool MCP

Python AST CLI

Native Inside Antigravity / Claude / Codex / Cursor

βœ… Native

⚠️ CLI Wrapper

⚠️ Partial

βœ… MCP Only

❌ Standalone

Signed-In BrowserOS Neo DOM &amp; Fetch Bridge

βœ… Built-in

⚠️ Isolated Container

❌

❌

❌

Barrier-Synchronized Socket Race Engine

βœ… Built-in

❌

❌

❌

❌

JWT Cracker + Forger &amp; GraphQL Clairvoyance

βœ… Built-in

⚠️ Partial

❌

⚠️ External CLI

❌

Cryptographic OOB Canary &amp; Ephemeral Listener

βœ… Built-in

βœ… OOB

⚠️ Partial

❌

❌

Zero-Setup SQLite Attack Graph + Mermaid

βœ… Built-in

❌

⚠️ Needs Neo4j/PG

❌

❌

SPA Lazy-Chunk Reconstruction (Webpack/Vite/Next)

βœ… Built-in

⚠️ Partial

❌

❌

❌

Multi-Language White-Box Taint SAST

βœ… Py / TS / Go / PHP

βœ… Dynamic + Code

❌ Black-Box

❌

⚠️ Py 3.10 Only

Deterministic WAF Soft-200 &amp; BOLA Diff Oracle

βœ… Built-in

βœ… PoC Validation

⚠️ LLM-Judged

❌ Raw Stdout

❌ Static Only

Runtime Dependencies

βœ… 0 (Pure Stdlib)

Docker + Node/LLM

Docker + DB + Kali

150+ CLI Tools

Python 3.10 + jedi

viperclaw/
β”œβ”€β”€ .claude-plugin/               # Claude Code Marketplace & Plugin manifests
β”œβ”€β”€ .github/workflows/ci.yml      # GitHub Actions CI matrix (Python 3.10, 3.11, 3.12)
β”œβ”€β”€ assets/                       # Custom Light-Theme SVG Banner & Architecture Diagrams
β”œβ”€β”€ docs/README.md                # Beginner-to-Pro Complete Usage & Best-Utilization Guide
β”œβ”€β”€ logo.png                      # Lightweight 512x512 transparent square emblem
β”œβ”€β”€ skills/                       # 14 Methodology-Driven Offensive Skills (SKILL.md)
β”œβ”€β”€ src/viperclaw/                # Zero-Dependency Python 3.10+ Core Package
β”‚   β”œβ”€β”€ cli.py                    # CLI entrypoints (`viperclaw` & `vclaw`)
β”‚   β”œβ”€β”€ mcp_server.py             # Phase-Gated 13-Tool JSON-RPC 2.0 stdio MCP Server
β”‚   β”œβ”€β”€ core/                     # Stigmergic Attack Graph, Proof Oracle & SARIF Reporter
β”‚   └── analyzers/                # Live DAST, Race, JWT, GraphQL, OOB, BrowserOS, Taint, JS & HAR
β”œβ”€β”€ tests/test_viperclaw.py       # 11 End-to-End & Adversarial QA Regression Suites
β”œβ”€β”€ CITATION.cff                  # Academic & Research Citation Metadata
β”œβ”€β”€ glama.json                    # MCP Registry Manifest
β”œβ”€β”€ llms.txt                      # AI / LLM Context Discovery Index
└── pyproject.toml                # PEP 621 Zero-Dependency Package Configuration
  • Why use ViperClaw instead of a standalone Docker security stack?
    If you already use Google Antigravity, Claude Code, OpenAI Codex, or Cursor, spinning up a separate 5-container Docker stack with its own LLM API billing is redundant. ViperClaw installs in 2 seconds with zero dependencies and turns your existing coding agent into an evidence-gated AppSec &amp; architecture audit platform.

  • How does ViperClaw prevent AI hallucinations and WAF "Soft-200" false positives?
    Generic AI wrappers often report 200 OK HTML challenge pages from Cloudflare, Akamai, Imperva, or CloudFront as vulnerabilities. ViperClaw's ProofOracle filters WAF soft-blocks, diffs structural JSON keys for BOLA/IDOR, and enforces a strict 7-Question Pre-Submission Gate ("No Receipt, No Report").

  • How do I run the regression test suite?
    Run pytest -v from the repository root to execute all 11 end-to-end and adversarial QA test suites.


πŸ“œ Documentation, Security & License

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      AI-powered bug bounty hunting platform that integrates security tools (OWASP ZAP, Caido, Burp Suite) for automated reconnaissance, vulnerability testing, JavaScript analysis, and finding management with PostgreSQL storage.
      47
      51
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables users to run AI-assisted security reviews across bug hunting, application security, and infrastructure security by orchestrating tools such as Semgrep, CodeQL, Trivy, Gitleaks, OSV-Scanner, and OWASP ZAP. It produces local JSON and HTML reports with findings, evidence, and unperformed check status for further investigation.
      3
      -
    • A
      license
      B
      quality
      B
      maintenance
      Enables AI agents to conduct authorized pentests and bug-bounty workflows with scope enforcement, audit logging, reconnaissance, safe vulnerability checks, payload/wordlist generation, and professional report generation.
      14
      MIT