Skip to main content
Glama

AgentAegis MCP Server

Glama score

Every cybersecurity service, callable by any AI agent, billed per use.

AgentAegis is an MCP server that lets AI agents perform cybersecurity operations on demand — from compliance checks to vulnerability scans to code security analysis. It wraps best-in-class open-source scanning engines (nmap, Nuclei, sslyze, Semgrep, trufflehog, trivy) in clean, agent-discoverable tool definitions with structured inputs and outputs.

Phase 2 ships: HTTP transport for remote deployment, x402 micropayments, API key auth with monthly limits, Supabase persistence, webhooks, ISO 27001 + HIPAA frameworks, Railway deploy config, and a full test suite.

Quick Start

Local (stdio for Claude Desktop)

git clone https://github.com/astafford8488/agentaegis-mcp.git
cd agentaegis-mcp
pnpm install
cp .env.example .env  # add API keys
pnpm build

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "agentaegis": {
      "command": "node",
      "args": ["/path/to/agentaegis-mcp/dist/index.js"],
      "env": {
        "NVD_API_KEY": "...",
        "ABUSEIPDB_API_KEY": "...",
        "OTX_API_KEY": "...",
        "ABUSECH_API_KEY": "...",
        "HIBP_API_KEY": "..."
      }
    }
  }
}

Remote (HTTP, for agent platforms)

# Local dev
pnpm dev:http

# Production via Docker
docker compose -f docker/docker-compose.yml up -d

# Production via Railway
railway up

Connect from any MCP-aware agent:

POST https://your-host/mcp
Authorization: Bearer aegis_<your-api-key>

Related MCP server: SecOps MCP

Architecture

┌─────────────────────────────────────────────────────────┐
│         AI Agent (Claude, custom MCP client)            │
└────────────────┬───────────────────────┬─────────────────┘
                 │ stdio                 │ HTTP
                 │                       │
┌────────────────▼───────────┐  ┌────────▼─────────────────┐
│   stdio entry (index.ts)   │  │  HTTP entry (http-server)│
└────────────────┬───────────┘  └────────┬─────────────────┘
                 │                       │
                 │      ┌────────────────┴─────────────┐
                 │      │  Auth Gate                   │
                 │      │  - API key (DB-backed)       │
                 │      │  - x402 micropayment         │
                 │      └─────────────┬────────────────┘
                 │                    │
┌────────────────▼────────────────────▼──────────────────────┐
│              MCP Server (server.ts)                          │
│              20 Tool Handlers                                │
├──────────────────────────┬────────────────────────────────┤
│  Engine Wrappers         │  External APIs                  │
│  nmap, Nuclei, sslyze,   │  NVD, AbuseIPDB, AlienVault OTX + abuse.ch,    │
│  Semgrep, trufflehog,    │  HIBP, Shodan                   │
│  trivy                   │                                  │
├──────────────────────────┴────────────────────────────────┤
│  Sandbox    │ Rate Limit │ Target Validation │ Logging     │
└────────────────────────────────────────────────────────────┘
                            │
                  ┌─────────▼──────────┐
                  │  Supabase          │
                  │  - customers       │
                  │  - api_keys        │
                  │  - scan_jobs       │
                  │  - usage_log       │
                  │  - webhooks        │
                  └────────────────────┘

HTTP API (Phase 2)

Endpoint

Method

Auth

Description

/health

GET

None

Health check

/pricing

GET

None

Tool catalog with prices

/v1/customers

POST

None

Create customer account

/v1/customers/:id/api-keys

POST

None

Issue an API key

/v1/customers/:id/usage

GET

API key

Usage statistics

/v1/jobs/:jobId

GET

API key

Async scan job status

/mcp

POST

API key OR x402

MCP Streamable HTTP transport

Payment Flow

Option 1: API Key — Customer registers, gets a key, pays via prepaid balance or invoice. Each tool call deducts from the monthly budget.

curl -X POST https://api.agentaegis.org/v1/customers \
  -H "Content-Type: application/json" \
  -d '{"email":"you@company.com","name":"Your Name"}'

curl -X POST https://api.agentaegis.org/v1/customers/<id>/api-keys \
  -H "Content-Type: application/json" \
  -d '{"name":"production","monthly_limit_usd":100}'

Option 2: x402 Micropayment — No signup. Each tool call settles on-chain via USDC. The server returns 402 Payment Required with payment requirements; the client signs and retries with X-PAYMENT header.

Tool Catalog (28 tools: 23 paid + 5 free)

Live pricing is always at /pricing.

Tool

Category

Description

Price

compliance_framework_check

Compliance

SOC 2, ISO 27001, HIPAA, PCI-DSS, NIST CSF assessment

$2.00

evidence_collect

Compliance

Evidence collection plans for audit controls

$1.00

control_gap_analysis

Compliance

Prioritized remediation roadmap

$2.00

audit_report_generate

Compliance

Audit-ready compliance reports

$5.00

policy_generate

Compliance

Tailored security policy documents

$2.00

vuln_scan_network

Vuln Mgmt

Network port and vulnerability scan

$3.00

vuln_scan_web_app

Vuln Mgmt

OWASP Top 10 web app scan

$5.00

vuln_prioritize

Vuln Mgmt

Risk-based vulnerability prioritization

$1.00

cve_lookup

Vuln Mgmt

CVE details, CVSS, KEV status

$1.00

ssl_tls_audit

Vuln Mgmt

SSL/TLS configuration audit

$1.00

sast_scan

Code Security

Static security analysis

$5.00

secret_scan

Code Security

Hardcoded secret detection

$2.00

dependency_audit

Code Security

Dependency vulnerability scan

$2.00

incident_triage

Blue Team

Incident classification & response plan

$3.00

threat_intel_lookup

Blue Team

IOC reputation lookup

$2.00

dns_security_check

Blue Team

DNS security audit

$1.00

email_security_audit

Blue Team

Email security configuration audit

$2.00

access_review

Identity

Access privilege audit

$1.00

mfa_audit

Identity

MFA coverage assessment

$1.00

credential_check

Offensive

Breach database lookup

$2.00

vet_endpoint

Trust Layer

Composite PROCEED/CAUTION/BLOCK trust verdict on an endpoint before your agent calls or pays it

$3.00

scan_mcp_plugin

Trust Layer

Supply-chain scan of an MCP server/plugin before your agent installs or trusts it

$5.00

scan_skill

Trust Layer

Prompt-injection and over-broad-grant scan of an agent skill (SKILL.md)

$5.00

Free tools (no charge): help, account_balance, agent_whoami, agent_history, agent_scan_get.

Compliance Frameworks Supported

  • SOC 2 Type II — Full Trust Services Criteria (35 controls)

  • ISO 27001:2022 — All 4 Annex A control groups (93 controls)

  • HIPAA Security Rule — Administrative, physical, and technical safeguards (43 controls)

  • NIST CSF 2.0 — All 6 functions with categories

  • PCI DSS v4.0 — All 12 requirements with detailed controls (full evaluation logic)

Development

pnpm install        # Install dependencies
pnpm dev            # stdio mode (for Claude Desktop)
pnpm dev:http       # HTTP mode (with Streamable HTTP transport)
pnpm build          # Build for production
pnpm test           # Run vitest test suite (46 tests)

Deployment

railway login
railway init
railway up

Required env vars (set in Railway dashboard):

  • SUPABASE_URL, SUPABASE_SERVICE_KEY

  • X402_PAYEE_ADDRESS (your wallet)

  • NVD_API_KEY, ABUSEIPDB_API_KEY, OTX_API_KEY, ABUSECH_API_KEY, HIBP_API_KEY

Database setup

Run the migration in your Supabase SQL editor:

cat supabase/migrations/001_initial_schema.sql

Security Policy

  • Target validation: Only public IPs and registered domains. Private/reserved ranges blocked.

  • Scan isolation: Each scan runs in an isolated process with temp directory cleanup.

  • Code safety: Repos cloned shallow (depth=1), max 500MB, 5-minute timeout, no execution.

  • Secret redaction: Full secret values never returned — first 4 and last 4 characters only.

  • Rate limiting: Per API key AND per target. Max 5 concurrent scans, 10/hour per target.

  • Audit logging: All tool calls logged to usage_log (90-day retention).

  • API key hashing: Keys stored as SHA-256 hashes; raw keys never stored.

Responsible Use

AgentAegis scanning tools must only be used against systems you own or have explicit written authorization to test. By using this service, you agree that:

  1. You have authorization from the system owner to perform security testing

  2. You will not use these tools for unauthorized access or malicious purposes

  3. You accept responsibility for any scans initiated through your API key

License

MIT

Available Tools

28 tools
access_reviewCInspect

Audit user access against least-privilege.

Inputs: users (required), admin_roles, previous_scan_id, sensitive_permissions.

account_balanceAInspect

Returns the calling API key's prepaid balance, monthly limit, current month usage, and a breakdown of how many of each tool the customer can still afford. Free to call.

Inputs: no named parameters.

agent_historyAInspect

Lists your recent scans (scan_id, tool, target, status, time) so you can retrieve or chain from a prior result. Optional limit/tool/target/since filters. Free to call.

Inputs: tool, limit, since, target.

agent_scan_getAInspect

Retrieves one of your prior scans by scan_id, including the stored full output, so you can build on earlier results without re-paying. Free to call.

Inputs: scan_id (required), include_full_output.

agent_whoamiAInspect

Returns your persistent AgentAegis agent identity (agent_id), how you're identified (API key / wallet / anonymous session), and lifetime call count + spend. Free to call.

Inputs: no named parameters.

audit_report_generateDInspect

Generate audit-ready compliance reports.

Inputs: framework (required), report_date (required), report_type (required), organization_name (required), +2 more.

compliance_framework_checkCInspect

Assess an organization's security posture against a compliance framework (SOC 2, ISO 27001, HIPAA, PCI-DSS, NIST CSF).

Inputs: framework (required), organization_profile (required), previous_scan_id.

control_gap_analysisCInspect

Deep-dive analysis of compliance control gaps with remediation roadmap.

Inputs: framework (required), failing_controls (required), previous_scan_id, budget_constraint, +1 more.

credential_checkCInspect

Check email/domain in breach databases (HIBP).

Inputs: target (required), check_type (required), previous_scan_id.

cve_lookupCInspect

Look up CVE details, CVSS scores, and patches.

Inputs: cve_id (required), previous_scan_id.

dependency_auditCInspect

Audit dependencies for known vulnerabilities (npm, pip, Go, Ruby, Java, Cargo).

Inputs: source (required), previous_scan_id.

dns_security_checkBInspect

Check DNS security (SPF, DKIM, DMARC, DNSSEC).

Inputs: domain (required), previous_scan_id.

email_security_auditCInspect

Comprehensive email security audit.

Inputs: domain (required), previous_scan_id, include_mx_analysis.

evidence_collectCInspect

Generate evidence collection plans for compliance controls.

Inputs: framework (required), control_ids (required), integrations, previous_scan_id.

helpAInspect

Returns AgentAegis FAQ — authentication, balance/billing, tool catalog, async jobs, error codes, x402, rate limits, security. Optional topic filter. Free to call.

Inputs: topic.

incident_triageDInspect

Classify and respond to security incidents.

Inputs: indicators (required), incident_description (required), previous_scan_id, environment_context.

mfa_auditCInspect

Assess MFA coverage and strength.

Inputs: users (required), previous_scan_id.

policy_generateCInspect

Generate tailored security policy documents.

Inputs: industry (required), frameworks (required), policy_type (required), employee_count (required), +3 more.

sast_scanCInspect

Static analysis for security vulnerabilities. Supports Python, JS/TS, Java, Go, Ruby, PHP, C/C++.

Inputs: source (required), previous_scan_id, severity_threshold.

scan_mcp_pluginAInspect

Scan an MCP server (git repo or code) for supply-chain risk BEFORE trusting it — exfiltration (secrets/env to the network), prompt-injection sinks, dangerous capabilities, npm install hooks, obfuscation, plus Semgrep + secret scanning → a PROCEED/CAUTION/BLOCK verdict with findings.

Inputs: source (required), previous_scan_id.

scan_skillAInspect

Scan an agent SKILL (git repo or SKILL.md) for supply-chain risk BEFORE trusting it — prompt-injection / hidden-unicode in the instructions (hard block), over-broad allowed-tools grants, plus exfiltration, dangerous capabilities, secrets and obfuscation in bundled scripts → a PROCEED/CAUTION/BLOCK verdict.

Inputs: source (required), previous_scan_id.

secret_scanCInspect

Detect hardcoded secrets in source code.

Inputs: source (required), include_history, previous_scan_id.

ssl_tls_auditCInspect

Audit SSL/TLS configuration for a domain.

Inputs: hostname (required), port, previous_scan_id.

threat_intel_lookupCInspect

IOC lookup against threat intel feeds.

Inputs: indicator (required), indicator_type (required), previous_scan_id.

vet_endpointAInspect

Composite trust verdict (PROCEED/CAUTION/BLOCK) for an endpoint an agent is about to call or pay — combines TLS/cert health, DNS hygiene, threat-intel reputation, and domain age into one decision with reasons.

Inputs: endpoint (required), previous_scan_id.

vuln_prioritizeCInspect

Prioritize vulnerabilities by exploitability and business impact.

Inputs: findings (required), business_context, previous_scan_id.

vuln_scan_networkCInspect

Scan an IP/domain for open ports, services, and vulnerabilities.

Inputs: target (required), scan_type (required), async, port_range, +1 more.

vuln_scan_web_appCInspect

Scan a web app for OWASP Top 10 vulnerabilities.

Inputs: scan_depth (required), target_url (required), async, exclude_paths, +2 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 28 tools

    Disambiguation5/5

    Each tool targets a distinct security or compliance function. There is no ambiguity between similar-sounding tools like vuln_scan_network and vuln_scan_web_app because they clearly differentiate between network and web application scanning.

    Naming Consistency3/5

    Most tool names follow a noun_noun or noun_verb pattern in snake_case, but there is inconsistency: some are noun_verb (e.g., incident_triage), some are noun_noun (e.g., cve_lookup), and one is verb_noun (vet_endpoint). The naming is readable but lacks a strict uniform convention.

    Tool Count2/5

    With 28 tools, the server exceeds the typical upper bound for a well-scoped set. While the domain is broad (security and compliance), the number feels bloated and could be consolidated (e.g., combining related scans or audits).

    Completeness5/5

    The tool set covers the full lifecycle of security assessment and compliance: vulnerability scanning, compliance frameworks, audits, evidence collection, policy generation, incident triage, and account management. There are no obvious missing operations for the stated domain.

    Related MCP Connectors

    Related MCP Servers

    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables ethical security testing and attack surface management through SSL certificate validation, CVE queries, subdomain enumeration, security header analysis, and comprehensive reconnaissance capabilities. Designed for authorized penetration testing workflows with responsible disclosure practices.
      -
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Provides access to 13+ penetration testing and security audit tools through a unified MCP interface. Enables security professionals to perform vulnerability scanning, web fuzzing, network reconnaissance, and other security assessments through containerized tools like Nuclei, Nmap, SQLMap, and FFUF.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      AI-powered cybersecurity automation platform with 150+ security tools and 12+ autonomous AI agents for penetration testing, vulnerability assessment, and bug bounty hunting. Enables comprehensive security testing through intelligent tool selection and automated workflows.
      3
      -
    • A
      license
      A
      quality
      D
      maintenance
      A comprehensive security testing MCP server providing 51 tools for penetration testing, network forensics, memory analysis, and vulnerability assessment. It enables automated security audits and technical investigations across web applications, cloud environments, and network captures.
      51
      105 npm
      27
      MIT