aegis-x402-mcp
Connects MCP clients to AegisAudit for on-chain token security, pre-swap guardrails, reputation checks, web scraping, and audit monitoring via x402 payments on Base.
Run an all-in-one pre-swap security bundle with honeypot audit, DEX liquidity depth, counterparty KYA, and AP2 spend-limit checks ($0.20 USDC).
Request fresh, cache-bypassed priority token audits for sniper/HFT agents ($0.05 USDC).
Audit token contracts for security, honeypots, and buy/sell taxes ($0.01 USDC).
Preview token market pools, price, pair address, and DEX liquidity for free.
Verify counterparty wallet reputation, balances, nonce age, and sanctions flags ($0.01 USDC).
Scrape public webpages into clean LLM Markdown with extracted links ($0.005 USDC).
Monitor recent verified token audits across Base, Ethereum, and Solana for free.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@aegis-x402-mcp audit 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 for honeypot risk on Base"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
aegis-x402-mcp
Model Context Protocol (MCP) server for AegisAudit — Autonomous On-Chain Token Security, PreFlight Bundles, Honeypot Simulation, KYA Reputation, and Grounded AI over the x402 v2 Protocol on Base Mainnet.
aegis-x402-mcp connects Claude Desktop, Cursor, Windsurf, and autonomous trading bots directly to https://aegisaudit.org (local stdio CLI or hosted Streamable HTTP at https://aegisaudit.org/mcp). Every paid response includes a third-party verifiable ECDSA secp256k1 EIP-191 proofOfExecution receipt (/.well-known/poe-key.json), and upstream failures fail closed (HTTP 502, zero USDC charged).
Canonical Gateway:
https://aegisaudit.orgHosted Streamable HTTP MCP:
https://aegisaudit.org/mcpContact:
security@aegisaudit.org
Commercial Security SKUs & MCP Tools (8 Tools)
Tool Name | Price | Description |
| $0.20 USDC | Commercial SKU #1 (Flagship Pre-Swap Guard): Atomic multi-oracle honeypot audit + DEX liquidity depth + AP2 spend mandate + counterparty KYA + ECDSA PoE receipt. |
| $0.05 USDC | Commercial SKU #2: 100% cache-bypassed, fresh live-oracle scan for sniper bots & new Base pool launches. |
| $0.01 USDC | Commercial SKU #3: Multi-oracle smart contract bytecode inspection (GoPlus, Honeypot.is V2, DexScreener, Base RPC). |
| $0.01 USDC | Know-Your-Agent (KYA) counterparty wallet reputation, transaction nonce age, balances, and OFAC/GoPlus sanctions checks. |
| $0.005 USDC | Converts any public webpage into clean, token-efficient LLM Markdown and extracted links. |
| $0.005 USDC | OpenAI-compatible grounded LLM inference enriched with live Base/Ethereum on-chain security telemetry. |
| FREE | Real-time market pool, token price, pair address, and DEX liquidity without payment. |
| FREE | Real-time stream of latest verified settled token audits across Base, Ethereum, and Solana. |
Related MCP server: AgentRisk MCP
Trading Bot & Sniper Guard Examples (Base Mainnet)
Drop-in fail-closed pre-swap gates calling https://aegisaudit.org/api/v1/preflight/bundle ($0.20 USDC over x402 v2) before submitting a swap on Aerodrome or Uniswap:
TypeScript (
@x402/fetch+@x402/evm+viem):examples/base-sniper-guard.tsPython (zero external dependencies):
examples/base-sniper-guard.py
Inspect a live sample clearance response with zero payment:
curl -s https://aegisaudit.org/api/v1/sample/preflight3-Tier Frictionless Execution Architecture
Tier 1 — Zero-Config (Free Tier): Tools like
aegis_token_previewandaegis_recent_auditswork instantly out-of-the-box with zero configuration or keys.Tier 2 — Prepaid Credit Token (Recommended for Humans): Top up in 1-click at https://aegisaudit.org/pay to get a signed 24-hour credit token
aegis_credit_.... AddAEGIS_CREDIT_TOKENin your config. No local wallet key or per-call signing required.Tier 3 — Autonomous Agentic Wallet (For Autonomous Trading Bots & Power Users): Add
AEGIS_PRIVATE_KEYin your config. The local MCP client signs gasless EIP-3009 micro-settlements on Base Mainnet on-demand inside the MCP process. Keys never leave your machine. Security Allowlist Guard: The client strictly verifies the recipient and refuses to sign toward any address other than the official Aegis node (0x111ef680B6EFdd859FbEc473b907aCe95F0D1acB).
Quick Setup
Option 1: Claude Desktop
Add this configuration to your claude_desktop_config.json:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"aegis-security": {
"command": "npx",
"args": ["-y", "aegis-x402-mcp"],
"env": {
"AEGIS_CREDIT_TOKEN": "aegis_credit_your_token_or_leave_empty_for_free_tier"
}
}
}
}Option 2: Cursor (.cursor/mcp.json)
Create or update .cursor/mcp.json in your project root:
{
"mcpServers": {
"aegis-security": {
"command": "npx",
"args": ["-y", "aegis-x402-mcp"],
"env": {
"AEGIS_CREDIT_TOKEN": "aegis_credit_your_token"
}
}
}
}Option 3: Windsurf / Remote Streamable HTTP
Add to ~/.codeium/windsurf/mcp_config.json (or connect any Streamable HTTP MCP client to https://aegisaudit.org/mcp):
{
"mcpServers": {
"aegis-security": {
"command": "npx",
"args": ["-y", "aegis-x402-mcp"]
}
}
}Environment Variables
Variable | Description |
| Gateway URL (defaults to |
| Tier-bound 24h prepaid credit token generated from |
| Optional local EVM private key ( |
| Alias for |
| Pre-signed base64 EIP-3009 payment header or authorization token. |
Discovery & Registries
Canonical Docs & Agent Manifests:
aegisaudit.org/AGENTS.md·aegisaudit.org/llms-full.txt·aegisaudit.org/.well-known/x402.jsonOfficial MCP Registry: registry.modelcontextprotocol.io (
io.github.Goatincrypto/aegis-x402-mcp)Security Contact:
security@aegisaudit.org
License
MIT © 2026 Antigravity Autonomous Systems
Available Tools
7 toolsaegis_preflight_bundleAInspect
USE WHEN: An autonomous trading agent or sniper bot needs all-in-one pre-swap security: multi-oracle honeypot audit, DEX liquidity depth, counterparty KYA, and AP2 spend mandate limits in a single call ($0.20 USDC on Base).
Inputs: tokenAddress (required), chain, tradeAmountUsd, counterpartyAddress.
aegis_priority_auditBInspect
USE WHEN: A sniper bot or high-frequency trading agent requires a 100% fresh, un-cached multi-oracle token security audit with priority execution ($0.05 USDC on Base).
Inputs: address (required), chain.
aegis_recent_auditsAInspect
USE WHEN: Monitoring the real-time stream of recently scanned tokens on Base, Ethereum, and Solana (FREE).
Inputs: no named parameters.
aegis_token_auditAInspect
USE WHEN: Verifying smart contract security, honeypot traps, and buy/sell taxes before executing a token swap ($0.01 USDC on Base).
Inputs: address (required), chain.
aegis_token_previewAInspect
USE WHEN: Checking basic DEX market pool, price, and liquidity for any token without requiring payment (FREE).
Inputs: address (required), chain.
aegis_wallet_kyaAInspect
USE WHEN: Checking counterparty wallet reputation, transaction count, USDC/ETH balances, and GoPlus sanctions flags before transacting ($0.01 USDC on Base).
Inputs: address (required).
aegis_web_scrapeAInspect
USE WHEN: Scraping any public URL and converting the page into clean, token-efficient LLM Markdown ($0.005 USDC on Base).
Inputs: url (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct capability tier: free preview, free audit stream, standard paid audit, priority audit, wallet reputation, web scraping, and a bundle. The only friction is the audit trio (token_audit, priority_audit, preflight_bundle), which overlap in purpose, but the cost/freshness/bundling cues in the descriptions mostly resolve the choice.
All names share the aegis_ prefix and snake_case with a resource-qualified style (aegis_token_audit, aegis_wallet_kya, aegis_web_scrape). The internal ordering varies slightly (adjective-first in priority_audit, noun-first elsewhere), but the pattern is predictable.
Seven tools is well within the ideal range and each earns its place: two free discovery tools, two paid audit tiers, wallet KYA, scraping, and an all-in-one bundle. No redundant or filler tools are present.
The surface covers the core pre-trade workflow: market preview, security audit, priority audit, counterparty KYA, and a combined bundle, plus web scraping for research. Minor gaps exist—no standalone AP2 spend-mandate tool (only inside the bundle) and no lookup of a historical audit for a specific token beyond the recent stream—but agents can work around these.
Maintenance
Related MCP Connectors
Pre-trade token safety checks for AI agents on Solana and Base. x402 USDC per call, no key.
x402 contract tools and premium portfolio scans for AI agents on Base.
Real-time token contract safety scanner and honeypot auditor via x402 on Base.
Base token safety: one-call verdict, risk score, rug check, holders, momentum. x402 + free demo.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenancePay-per-use AI security and research tools for autonomous agents on Base, enabling honeypot detection, risk assessment, wallet analysis, and yield optimization via the x402 protocol.1-

AgentRisk MCPofficial
AlicenseAqualityCmaintenanceEnables AI agents on Base to call a check_token_risk tool before trading, providing honeypot detection, LP-lock verification, brand impersonation checks, and live sell simulation across Uniswap V2/V3/V4 and Aerodrome with a clear risk score and should-trade decision.111 npmMIT- AlicenseNot gradedqualityCmaintenanceProvides onchain intelligence tools for Base, including token risk checks, wallet PnL, and leaderboard data, with paid calls settled per-request in USDC via x402.45 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to run honeypot and owner-power safety checks on Base tokens and to read wallet ETH and USDC balances, with every answer sourced from real chain data and paid per call in USDC via x402.MIT