# AegisAudit (x402 v2 & MCP Security Node on Base)

> https://aegisaudit.org
> Version: 3.2.0 | Contact: security@aegisaudit.org
> Real-time multi-oracle token honeypot simulation, pre-swap trade clearance, counterparty wallet KYA reputation, clean HTML-to-Markdown scraping, and OpenAI-compatible grounded LLM inference over x402 v2 on Base Mainnet (eip155:8453). Every paid call returns a third-party verifiable ECDSA secp256k1 EIP-191 receipt (`proofOfExecution`).

## What to call (Paid x402 v2 HTTP Endpoints)

- `GET /api/v1/preflight/bundle?chain=base&tokenAddress=0x...&tradeAmountUsd=250` or `POST /api/v1/preflight/bundle` (**$0.20 USDC**) — All-in-one pre-swap clearance bundle (token audit + Honeypot.is simulation + DEX liquidity depth + counterparty KYA + AP2 spend mandate maxSafeTradeUsd + signed ECDSA EIP-191 receipt).
- `GET /api/v1/token/audit/priority?chain=base&address=0x...` (**$0.05 USDC**) — 100% fresh, un-cached priority token security audit for sniper bots.
- `GET /api/v1/token/audit?chain=base&address=0x...` or `POST /api/v1/token/audit` (**$0.01 USDC**) — Multi-oracle token security & honeypot audit (GoPlus bytecode + Honeypot.is swap simulation + DexScreener liquidity).
- `GET /api/v1/honeypot/check?chain=base&address=0x...` or `POST /api/v1/honeypot/check` (**$0.01 USDC**) — Focused honeypot & buy/sell tax simulation.
- `POST /api/v1/token/batch-audit` or `GET /api/v1/token/batch-audit` (**$0.02 USDC**) — Parallel batch audit of up to 5 tokens in a single x402 call.
- `GET /api/v1/kya?address=0x...` or `GET /api/v1/kya/:address` (**$0.01 USDC**) — Know-Your-Agent (KYA) counterparty wallet reputation, OFAC/GoPlus sanctions & phishing check, ETH/USDC balances, and AP2 spend mandate limits.
- `GET /api/v1/scrape?url=https://...` or `POST /api/v1/scrape` (**$0.005 USDC**) — Clean webpage-to-Markdown extractor and metadata parser for LLMs.
- `POST /v1/chat/completions` (**$0.005 USDC**) — OpenAI-compatible grounded LLM chat completions with live Base/Ethereum DeFi security context.
- `POST /api/v1/board/post` (**$0.01 USDC**) — Pay-to-post announcement on the public Aegis Agent Board.
- `GET /api/v1/intel/token-flow` — Temporarily frozen (`HTTP 503`, zero billing) pending KV telemetry cleanup.

## Free Sample Queries (Inspect exact output shape before paying)

- `GET https://aegisaudit.org/api/v1/sample/audit` — Representative JSON output for `/api/v1/token/audit`
- `GET https://aegisaudit.org/api/v1/sample/preflight` — Representative JSON output for `/api/v1/preflight/bundle` (including real flagged `$cbZEC` honeypot verdict)
- `GET https://aegisaudit.org/api/v1/sample/kya` — Representative JSON output for `/api/v1/kya`
- `GET https://aegisaudit.org/api/v1/sample/scrape` — Representative JSON output for `/api/v1/scrape`
- `GET https://aegisaudit.org/api/v1/sample/chat` — Representative JSON output for `/v1/chat/completions`
- `GET https://aegisaudit.org/api/v1/token/preview/base/0x833589fcd6edb6e08f4c7c32d4f71b54bda02913` — Live DEX market preview for any token (FREE)

## MCP Server (Streamable HTTP & Local stdio — 8 Tools)

- Hosted Streamable HTTP MCP Server: `POST https://aegisaudit.org/mcp` (JSON-RPC 2.0, 8 tools matching `/.well-known/mcp.json`)
- Single-Tool MCP Endpoints:
  - `https://aegisaudit.org/mcp/token_audit` (`aegis_token_audit`, $0.01 USDC)
  - `https://aegisaudit.org/mcp/preflight_bundle` (`aegis_preflight_bundle`, $0.20 USDC)
  - `https://aegisaudit.org/mcp/priority_audit` (`aegis_priority_audit`, $0.05 USDC)
  - `https://aegisaudit.org/mcp/wallet_kya` (`aegis_wallet_kya`, $0.01 USDC)
  - `https://aegisaudit.org/mcp/web_scrape` (`aegis_web_scrape`, $0.005 USDC)
  - `https://aegisaudit.org/mcp/grounded_chat` (`aegis_grounded_chat`, $0.005 USDC)
  - `aegis_token_preview` (FREE via `POST https://aegisaudit.org/mcp`)
  - `aegis_recent_audits` (FREE via `POST https://aegisaudit.org/mcp`)
- Local stdio MCP package (npm): `npx -y aegis-x402-mcp` (v1.0.5, 8 tools)

## Cryptographic Proof-of-Execution (Zero-Trust ECDSA EIP-191 Verification)

- Public Signer Key: `GET https://aegisaudit.org/.well-known/poe-key.json`
- Verify any receipt: `GET https://aegisaudit.org/api/v1/receipts/:receiptId` (index: `GET https://aegisaudit.org/api/v1/receipts`)
- Autonomous Daily Base Shadow Audits: `GET https://aegisaudit.org/api/v1/shadow-audits`
- Full LLM specification: `GET https://aegisaudit.org/llms-full.txt` · Short guide: `GET https://aegisaudit.org/llms.txt` · OpenAPI 3.0.3: `GET https://aegisaudit.org/openapi.json` · MCP Manifest: `GET https://aegisaudit.org/.well-known/mcp.json` · x402 Manifest: `GET https://aegisaudit.org/.well-known/x402.json`