AgentAegis
AgentAegis lets AI agents perform on-demand cybersecurity operations, billed per use. Here's what you can do:
Compliance & Governance
Assess posture against SOC 2, ISO 27001, HIPAA, PCI-DSS, and NIST CSF
Generate evidence collection plans, control gap analyses, audit-ready reports, and tailored security policies
Vulnerability Management
Scan networks (open ports/services), web apps (OWASP Top 10), SSL/TLS configs, and dependencies
Look up CVE details (CVSS, KEV status, patches) and prioritize findings by risk
Code Security
Static analysis (SAST) for Python, JS/TS, Java, Go, Ruby, PHP, C/C++
Detect hardcoded secrets in source code or git history
Audit dependencies (npm, pip, Go, Ruby, Java, Cargo) for known vulnerabilities
Blue Team & Threat Intelligence
Triage security incidents and generate response plans
Look up IOCs (IPs, domains, URLs, file hashes) against threat intel feeds (AbuseIPDB, AlienVault OTX, abuse.ch)
Check DNS security (SPF, DKIM, DMARC, DNSSEC) and audit email security configurations
Identity & Access Management
Audit user access against least-privilege principles
Assess MFA coverage and strength
Check emails/domains against breach databases (Have I Been Pwned)
Agent Safety & Supply Chain Security
Vet external endpoints (TLS/cert health, DNS hygiene, threat intel, domain age) before calling or paying them
Scan MCP plugins and agent skills for exfiltration risks, prompt injection, and dangerous capabilities
Account & History (Free)
Check balance, usage, and tool affordability
List recent scans and retrieve full outputs of prior scans by ID to chain workflows without re-paying
Retrieve persistent agent identity and lifetime usage stats
Provides threat intelligence lookup capabilities by integrating with abuse.ch, allowing AI agents to check indicators of compromise (IOCs) such as IP addresses and domains against known malicious activity databases.
AgentAegis MCP Server
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 buildAdd 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 upConnect 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 |
| GET | None | Health check |
| GET | None | Tool catalog with prices |
| POST | None | Create customer account |
| POST | None | Issue an API key |
| GET | API key | Usage statistics |
| GET | API key | Async scan job status |
| 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 (20 tools)
Tool | Category | Description | Price |
| Compliance | SOC 2, ISO 27001, HIPAA, PCI-DSS, NIST CSF assessment | $0.50 |
| Compliance | Evidence collection plans for audit controls | $0.25 |
| Compliance | Prioritized remediation roadmap | $0.50 |
| Compliance | Audit-ready compliance reports | $1.00 |
| Compliance | Tailored security policy documents | $0.50 |
| Vuln Mgmt | Network port and vulnerability scan | $1.00 |
| Vuln Mgmt | OWASP Top 10 web app scan | $1.50 |
| Vuln Mgmt | Risk-based vulnerability prioritization | $0.25 |
| Vuln Mgmt | CVE details, CVSS, KEV status | $0.10 |
| Vuln Mgmt | SSL/TLS configuration audit | $0.25 |
| Code Security | Static security analysis | $1.00 |
| Code Security | Hardcoded secret detection | $0.50 |
| Code Security | Dependency vulnerability scan | $0.50 |
| Blue Team | Incident classification & response plan | $0.75 |
| Blue Team | IOC reputation lookup | $0.25 |
| Blue Team | DNS security audit | $0.25 |
| Blue Team | Email security configuration audit | $0.50 |
| Identity | Access privilege audit | $0.50 |
| Identity | MFA coverage assessment | $0.25 |
| Offensive | Breach database lookup | $0.50 |
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 (Recommended)
railway login
railway init
railway upRequired env vars (set in Railway dashboard):
SUPABASE_URL,SUPABASE_SERVICE_KEYX402_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.sqlSecurity 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:
You have authorization from the system owner to perform security testing
You will not use these tools for unauthorized access or malicious purposes
You accept responsibility for any scans initiated through your API key
License
MIT
Maintenance
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/astafford8488/agentaegis-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server