@project-aegis/mcp-server

Aegis MCP Server

Dependency-free stdio MCP server for Aegis Smart Accounts.

It gives agents a typed interface for current v12 deployment metadata across Base mainnet, Base Sepolia, Sepolia, and Arc Testnet, DeFi selector support, policy amount conversion, API endpoint discovery, and optional authenticated Aegis API calls.

Run

From npm:

npx -y @project-aegis/mcp-server

From a local checkout:

node mcp/aegis/server.mjs

Example MCP client config:

{
  "mcpServers": {
    "aegis": {
      "command": "npx",
      "args": ["-y", "@project-aegis/mcp-server"],
      "env": {
        "AEGIS_API_URL": "https://api.projectaegis.ai",
        "AEGIS_DASHBOARD_API_KEY": "optional-api-key",
        "AEGIS_RPC_URL": "optional-rpc-url"
      }
    }
  }
}

Local checkout config:

{
  "mcpServers": {
    "aegis": {
      "command": "node",
      "args": ["/absolute/path/to/aegis/mcp/aegis/server.mjs"],
      "env": {
        "AEGIS_API_URL": "https://api.projectaegis.ai",
        "AEGIS_DASHBOARD_API_KEY": "optional-api-key",
        "AEGIS_RPC_URL": "optional-rpc-url"
      }
    }
  }
}

Tools

• aegis_supported_chains
• aegis_get_contracts
• aegis_get_defi_support
• aegis_amount_to_base_units
• aegis_preflight_transaction
• aegis_api_endpoints
• aegis_api_request

aegis_api_request requires AEGIS_DASHBOARD_API_KEY or AEGIS_API_KEY and only accepts /api/v1/... paths.

aegis_preflight_transaction requires a chain RPC URL via AEGIS_RPC_URL or the tool's rpc_url argument. It calls the live v12 PermissionEnforcer.checkAction(agentId, permissionId, actionHash, actionData) path and checks EntryPoint deposit/native ETH prefund readiness for a supplied UserOperation gas envelope. It does not submit a UserOperation and does not replace bundler simulation.

Smoke Test

cd mcp/aegis
npm run smoke