static configuration vulnerability scanning with 102+ rule registry
Discovers Claude-related configuration files (settings.json, mcp.json, CLAUDE.md) across the filesystem and runs them through a curated registry of 102+ static analysis rules organized by threat category (secrets, permissions, hooks, MCP, prompt injection). Each rule produces a Finding object with severity level, vulnerability description, and remediation steps, enabling systematic detection of misconfigurations before runtime.
Unique: Implements a domain-specific rule registry tailored to Claude Code + MCP threat model (102+ rules covering secrets, permissions, hooks, supply chain, prompt injection) rather than generic SAST tools; rules are organized by vulnerability category and include built-in remediation guidance specific to agent configurations
vs alternatives: More specialized for AI agent security than generic code scanners (Semgrep, Snyk) because it understands MCP server semantics, hook injection patterns, and prompt-based capability escalation unique to agent architectures
hardcoded secrets detection with multi-provider pattern matching
Scans configuration files for exposed API keys, tokens, and private keys using pattern matching rules for Anthropic, OpenAI, AWS, and other providers. Detects both common formats (e.g., sk-* prefixes) and entropy-based anomalies in string values, flagging findings with severity levels and remediation steps recommending environment variable substitution or secret management tools.
Unique: Combines provider-specific pattern matching (Anthropic sk-*, OpenAI sk-*, AWS AKIA*) with entropy-based anomaly detection to catch both well-known secret formats and custom tokens; integrates with AgentShield's Finding system to provide context-aware remediation (e.g., 'use ANTHROPIC_API_KEY environment variable instead')
vs alternatives: More targeted for agent configurations than generic secret scanners (git-secrets, Snyk) because it understands where secrets appear in MCP server definitions and hook configurations, not just source code
supply chain verification with source authenticity and maintenance status checks
Validates the authenticity and trustworthiness of MCP server sources by cross-referencing against known-good registries, checking maintainer reputation, and verifying code signatures. Assesses maintenance status (last update, active development, community engagement) to identify abandoned or unmaintained servers that pose supply chain risks. Integrates with GitHub API to gather maintainer and repository metadata.
Unique: Integrates with GitHub API to gather maintainer metadata, repository activity, and code signatures; assesses both source authenticity (is this really from the claimed maintainer?) and maintenance status (is this actively developed?) to identify supply chain risks beyond just CVE databases
vs alternatives: More thorough than generic dependency scanners because it validates source authenticity and maintenance status, not just known vulnerabilities; provides context about maintainer reputation and project health
vulnerability severity scoring and risk prioritization engine
Aggregates findings from all scanning modules (static rules, deep scan, taint analysis, injection testing, sandbox monitoring) and computes a composite vulnerability severity score based on exploitability, impact, and blast radius. Prioritizes findings for remediation using a scoring engine that considers attack complexity, required privileges, and potential damage. Generates risk reports with remediation guidance ranked by severity.
Unique: Implements a composite scoring engine that combines findings from multiple analysis modules (static rules, deep scan, taint analysis, injection testing, sandbox) into a unified risk score; prioritizes remediation based on exploitability and impact rather than just rule severity
vs alternatives: More sophisticated than simple rule-based severity assignment because it considers attack complexity, required privileges, and blast radius; aggregates multiple analysis techniques into a unified risk metric
miniclaw secure agent runtime with tool whitelist and egress firewall
Provides a hardened, minimal agent runtime (MiniClaw) that enforces security policies at execution time. Implements a tool whitelist that only allows explicitly approved tools, path sanitization for file access, and an egress firewall that prevents unauthorized network requests. Acts as a secure alternative to standard agent setups, with hooks into the agent lifecycle to validate tool calls against a RuntimePolicy before execution.
Unique: Implements a minimal, hardened agent runtime (MiniClaw) that enforces security policies at execution time through tool whitelisting, path sanitization, and egress firewall; integrates with AgentShield's policy definitions to enforce detected security requirements
vs alternatives: More practical than relying solely on static analysis because it enforces security policies at runtime; more lightweight than full sandboxing because it only restricts specific dangerous operations rather than isolating the entire runtime
ci/cd integration with github actions and baseline quality gates
Provides GitHub Action integration that runs AgentShield scans automatically on pull requests and commits. Supports baseline comparison to detect regressions (new vulnerabilities introduced), quality gates that fail builds if severity thresholds are exceeded, and watch mode that alerts on configuration changes. Integrates with GitHub's status checks and pull request reviews to block merges with critical vulnerabilities.
Unique: Integrates with GitHub Actions to run AgentShield scans automatically on commits/PRs; supports baseline comparison to detect regressions and quality gates that fail builds if severity thresholds are exceeded; provides GitHub App integration for enhanced permissions and pull request review comments
vs alternatives: More integrated than running AgentShield manually because it automates scanning and blocks risky merges; more practical than generic security scanning tools because it understands agent-specific vulnerabilities
auto-fix engine with configuration remediation and policy initialization
Automatically generates and applies fixes for detected vulnerabilities, including moving hardcoded secrets to environment variables, removing wildcard tool permissions, sanitizing hook code, and pinning MCP server versions. Provides an initialization mode that creates secure baseline configurations from scratch. Uses code transformation patterns to modify configuration files safely while preserving structure and comments.
Unique: Implements code transformation patterns that safely modify configuration files to fix detected vulnerabilities (moving secrets to env vars, removing wildcard permissions, pinning versions) while preserving file structure and comments; provides initialization mode for creating secure baseline configurations
vs alternatives: More practical than manual remediation because it automates fix application; more careful than generic code transformers because it understands agent configuration semantics and preserves structure
organizational policy enforcement with custom rules and compliance reporting
Enables organizations to define custom security policies that extend AgentShield's built-in rules, enforcing organization-specific requirements (e.g., 'all MCP servers must be from approved registry', 'no external network access'). Generates compliance reports showing which agents meet organizational policies and which require remediation. Integrates with policy management systems to enforce policies across multiple agent projects.
Unique: Extends AgentShield's built-in rules with organization-specific policies that can enforce custom security requirements; generates compliance reports showing which agents meet organizational policies and provides remediation guidance for non-compliant configurations
vs alternatives: More flexible than fixed rule sets because it allows organizations to define custom policies; more practical than manual compliance audits because it automates policy checking and reporting
+9 more capabilities