How automoxcommunity/automox-mcp works
Automox MCP Server lets an AI assistant invoke Automox operations through MCP tools and resources, returning management and compliance results. The main path is client request → MCP server registration and dispatch → domain tool/workflow → Automox API → response. The repository also exposes guided prompts and interactive resource apps, spanning device inventory/search, policy and patch management, auditing, groups, webhooks, vulnerability remediation, and related operations. Edges reflect README statements or source-index references and excerpts; some domain modules were not sampled, so their internal calls are not expanded.
Main entry points: client.py HTTP client · server.py MCP server · __init__.py Tool registry · device_search_tools.py Device tools
Components 21
MCP entry
- MCP server
src/automox_mcp/server.py - Tool registry
src/automox_mcp/tools/__init__.py
Automox operations
- Device tools
src/automox_mcp/tools/device_search_tools.py - Device inventory and search
src/automox_mcp/workflows/device_search.py - Policy tools
src/automox_mcp/tools/policy_tools.py - Policy operations
src/automox_mcp/workflows/policy_crud.py - Account and audit tools
src/automox_mcp/tools/account_tools.py - Webhook tools
src/automox_mcp/tools/webhook_tools.py - Webhook operations
src/automox_mcp/workflows/webhooks.py - Other domain tools
src/automox_mcp/tools - Other domain workflows
src/automox_mcp/workflows
Guidance and apps
- Resources registry
src/automox_mcp/resources/__init__.py - Guided resource apps
src/automox_mcp/resources - Guided prompts
src/automox_mcp/prompts/__init__.py
Shared foundations
- HTTP client
src/automox_mcp/client.py - Input and output schemas
src/automox_mcp/schemas.py - Tooling utilities
src/automox_mcp/utils/tooling.py - Response sanitizer
src/automox_mcp/utils/sanitize.py - Response helpers
src/automox_mcp/utils/response.py
Other components
- AI assistant
- Automox API
Connections 22
- AI assistant → MCP server: sends MCP requests
README.md - MCP server → Tool registry: registers tools
src/automox_mcp/server.py - MCP server → Resources registry: registers resources
src/automox_mcp/server.py - MCP server → Guided prompts: registers prompts
src/automox_mcp/server.py - Tool registry → Device tools: loads tool modules
src/automox_mcp/tools/__init__.py - Device tools → Device inventory and search: invokes workflows
src/automox_mcp/tools/device_search_tools.py - Device inventory and search → HTTP client: sends API requests
src/automox_mcp/workflows/device_search.py - Policy tools → Policy operations: invokes workflows
src/automox_mcp/tools/policy_tools.py - Policy operations → HTTP client: sends API requests
src/automox_mcp/workflows/policy_crud.py - Account and audit tools → Resources registry: uses app module
src/automox_mcp/tools/account_tools.py - Webhook tools → Webhook operations: invokes workflows
src/automox_mcp/tools/webhook_tools.py - Webhook operations → HTTP client: sends API requests
src/automox_mcp/workflows/webhooks.py - Other domain tools → Other domain workflows: invokes domain workflows
src/automox_mcp/tools/webhook_tools.py - Other domain workflows → HTTP client: calls Automox API
src/automox_mcp/workflows/webhooks.py - Resources registry → Guided resource apps: loads resource modules
src/automox_mcp/resources/__init__.py - HTTP client → Automox API: makes HTTP requests
README.md - Tool registry → Tooling utilities: uses shared helpers
src/automox_mcp/tools/__init__.py - Tool registry → HTTP client: uses API client
src/automox_mcp/tools/__init__.py - Device tools → Input and output schemas: uses schemas
src/automox_mcp/tools/device_search_tools.py - Policy tools → Input and output schemas: uses schemas
src/automox_mcp/tools/policy_tools.py - Tooling utilities → Response sanitizer: sanitizes responses
src/automox_mcp/utils/tooling.py - Device inventory and search → Response helpers: builds response metadata
src/automox_mcp/workflows/device_search.py