Skip to main content
Glama

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.

npm version License: MIT Network: Base x402 Protocol

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.org

  • Hosted Streamable HTTP MCP: https://aegisaudit.org/mcp

  • Contact: security@aegisaudit.org


Commercial Security SKUs & MCP Tools (8 Tools)

Tool Name

Price

Description

aegis_preflight_bundle

$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.

aegis_priority_audit

$0.05 USDC

Commercial SKU #2: 100% cache-bypassed, fresh live-oracle scan for sniper bots & new Base pool launches.

aegis_token_audit

$0.01 USDC

Commercial SKU #3: Multi-oracle smart contract bytecode inspection (GoPlus, Honeypot.is V2, DexScreener, Base RPC).

aegis_wallet_kya

$0.01 USDC

Know-Your-Agent (KYA) counterparty wallet reputation, transaction nonce age, balances, and OFAC/GoPlus sanctions checks.

aegis_web_scrape

$0.005 USDC

Converts any public webpage into clean, token-efficient LLM Markdown and extracted links.

aegis_grounded_chat

$0.005 USDC

OpenAI-compatible grounded LLM inference enriched with live Base/Ethereum on-chain security telemetry.

aegis_token_preview

FREE

Real-time market pool, token price, pair address, and DEX liquidity without payment.

aegis_recent_audits

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:

Inspect a live sample clearance response with zero payment:

curl -s https://aegisaudit.org/api/v1/sample/preflight

3-Tier Frictionless Execution Architecture

  1. Tier 1 — Zero-Config (Free Tier): Tools like aegis_token_preview and aegis_recent_audits work instantly out-of-the-box with zero configuration or keys.

  2. 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_.... Add AEGIS_CREDIT_TOKEN in your config. No local wallet key or per-call signing required.

  3. Tier 3 — Autonomous Agentic Wallet (For Autonomous Trading Bots & Power Users): Add AEGIS_PRIVATE_KEY in 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.json

  • Windows: %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

AEGIS_GATEWAY_URL

Gateway URL (defaults to https://aegisaudit.org).

AEGIS_CREDIT_TOKEN

Tier-bound 24h prepaid credit token generated from /pay or prior X-Aegis-Credit-Token settlement headers.

AEGIS_PRIVATE_KEY

Optional local EVM private key (0x...) used in-process to sign EIP-3009 USDC authorizations on Base without keys ever leaving your machine.

AEGIS_API_KEY

Alias for AEGIS_CREDIT_TOKEN / prepaid enterprise API key.

X402_PAYMENT_HEADER

Pre-signed base64 EIP-3009 payment header or authorization token.


Discovery & Registries


License

MIT © 2026 Antigravity Autonomous Systems

Available Tools

7 tools
aegis_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

    A3.8/5.0

    Scored across 7 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      1
      11 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides 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 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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