How okta/okta-mcp-server works
This is an MCP server that lets an LLM client manage an Okta organization through natural-language requests. The main path is client request → scope-filtered MCP tool → authenticated Okta SDK call → response serialization. Domain tools cover identity, access controls, device assurance, customization, and audit logs. The README documents additional CRUD capabilities and two authentication modes; unsampled tool implementations are represented by their exact source paths, while edges are limited to relationships shown by the README or SOURCE INDEX.
Main entry points: server.py MCP Server · client.py Okta SDK Client · users.py User Management · groups.py Group Management
Components 23
MCP Runtime
- MCP Server
src/okta_mcp_server/server.py
Identity Management
- User Management
src/okta_mcp_server/tools/users/users.py - Group Management
src/okta_mcp_server/tools/groups/groups.py - User Resources
src/okta_mcp_server/tools/user_resources/user_resources.py - Application Management
src/okta_mcp_server/tools/applications/applications.py
Access and Audit
- Policy Management
src/okta_mcp_server/tools/policies/policies.py - Device Assurance
src/okta_mcp_server/tools/device_assurance/device_assurance.py - System Logs
src/okta_mcp_server/tools/system_logs/system_logs.py - Login Failure Queries
src/okta_mcp_server/tools/system_logs/login_failures.py
Org Customization
- Brands and Domains
src/okta_mcp_server/tools/customization - Custom Pages
src/okta_mcp_server/tools/customization/custom_pages/custom_pages.py - Custom Templates
src/okta_mcp_server/tools/customization/custom_templates/custom_templates.py - Themes
src/okta_mcp_server/tools/customization/themes/themes.py
Shared Services
- Scope Filtering
src/okta_mcp_server/utils/scope_guard.py - Authentication
src/okta_mcp_server/utils/auth/auth_manager.py - Okta SDK Client
src/okta_mcp_server/utils/client.py - JSON Responses
src/okta_mcp_server/utils/serialization.py - Pagination
src/okta_mcp_server/utils/pagination.py - Input Validation
src/okta_mcp_server/utils/validation.py - Destructive-Action Confirmation
src/okta_mcp_server/utils/elicitation.py - Confirmation Messages
src/okta_mcp_server/utils/messages.py
Other components
- MCP Client / Agent
- Okta APIs
Connections 30
- MCP Client / Agent → MCP Server: sends requests
README.md - MCP Server → Authentication: initializes authentication
src/okta_mcp_server/server.py - MCP Server → Scope Filtering: filters tools
src/okta_mcp_server/server.py - MCP Server → User Management: registers tools
src/okta_mcp_server/server.py - MCP Server → Group Management: registers tools
src/okta_mcp_server/server.py - MCP Server → Application Management: registers tools
src/okta_mcp_server/server.py - MCP Server → Policy Management: registers tools
src/okta_mcp_server/server.py - MCP Server → Device Assurance: registers tools
src/okta_mcp_server/server.py - MCP Server → System Logs: registers tools
src/okta_mcp_server/server.py - MCP Server → Login Failure Queries: registers tools
src/okta_mcp_server/server.py - MCP Server → Brands and Domains: registers tools
src/okta_mcp_server/server.py - MCP Server → Custom Pages: registers tools
src/okta_mcp_server/server.py - MCP Server → Custom Templates: registers tools
src/okta_mcp_server/server.py - MCP Server → Themes: registers tools
src/okta_mcp_server/server.py - Authentication → Okta SDK Client: provides credentials
src/okta_mcp_server/utils/client.py - Okta SDK Client → Okta APIs: calls
README.md - User Management → Okta SDK Client: requests client
src/okta_mcp_server/tools/users/users.py - Group Management → Okta SDK Client: requests client
src/okta_mcp_server/tools/groups/groups.py - Application Management → Okta SDK Client: requests client
src/okta_mcp_server/tools/applications/applications.py - Device Assurance → Okta SDK Client: requests client
src/okta_mcp_server/tools/device_assurance/device_assurance.py - MCP Server → JSON Responses: configures responses
src/okta_mcp_server/server.py - User Management → Pagination: uses pagination
src/okta_mcp_server/tools/users/users.py - Group Management → Pagination: uses pagination
src/okta_mcp_server/tools/groups/groups.py - Custom Templates → Pagination: uses pagination
src/okta_mcp_server/tools/customization/custom_templates/custom_templates.py - User Management → Destructive-Action Confirmation: confirms destructive actions
src/okta_mcp_server/tools/users/users.py - Group Management → Destructive-Action Confirmation: confirms destructive actions
src/okta_mcp_server/tools/groups/groups.py - Application Management → Destructive-Action Confirmation: confirms destructive actions
src/okta_mcp_server/tools/applications/applications.py - Destructive-Action Confirmation → Confirmation Messages: uses prompts
src/okta_mcp_server/tools/groups/groups.py - Device Assurance → Input Validation: validates policy data
src/okta_mcp_server/tools/device_assurance/device_assurance.py - MCP Client / Agent → MCP Server: receives responses
README.md