@project-aegis/mcp-server

Aegis MCP Server

Dependency-free stdio MCP server for Aegis Smart Accounts.

It gives agents typed live account discovery, readiness diagnosis, permission/quota reads, error decoding, current v14 deployment metadata, DeFi selector support, policy amount conversion, 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_resolve_account_context
• aegis_doctor
• aegis_get_permission_state
• aegis_decode_error
• aegis_preflight_transaction
• aegis_api_endpoints
• aegis_api_request

aegis_doctor and aegis_api_request require AEGIS_DASHBOARD_API_KEY or AEGIS_API_KEY. Generic API requests only accept /api/v1/... paths.

aegis_resolve_account_context and aegis_get_permission_state follow the account's on-chain enforcer() to its registries. They do not assume the current deployment applies to an older account.

aegis_preflight_transaction requires a chain RPC URL via AEGIS_RPC_URL or the tool's rpc_url argument. It calls the live v14 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