Okta Managed MCP Server overview

Learn how the Okta Managed MCP Server connects LLM clients to Okta APIs so you can manage your org using natural language.

Early Access release

The Okta Managed MCP Server connects your LLM client to Okta APIs. It allows you to manage your org using natural language across Identity and Access Management (IAM) and Okta Identity Governance (OIG) modules. Instead of navigating multiple Admin Console menus or writing API calls, you can ask an AI agent to query user profiles, check app assignments, review governance records, and perform tasks like creating a user or checking group membership.

Traditional identity automation and Okta Open Source MCP Server deployments have the following challenges:

  • Complex custom integrations: You must write and maintain custom code to connect your AI agents to APIs. This includes handling API formatting, security policies, and token management.
  • Manual setup and maintenance: You must manually install Python and manage package dependencies for Okta Open Source MCP Server.

As a cloud-hosted service, Okta Managed MCP Server requires no local installation. All requests are authenticated in real time based on the scopes attached to your access token and user permissions.

For a comparison of hosting, setup, and ideal use cases for the Okta Open Source MCP Server and the Okta Managed MCP Server, see Choose a deployment option.

For a full list of supported capabilities, see Okta Managed MCP Server supported features.

To set up and start using the Okta Managed MCP Server, see Getting started.

Benefits

Fast, zero-infrastructure setup
No local installation is required. Connect your LLM client and start onboarding immediately.
Improved LLM performance
Reduce token usage and AI hallucinations with scope-based tool loading and response minification.
Strict schema validation
The server enforces JSON schema definitions for every tool input. Requests with unexpected fields, unsupported parameters, or invalid values are dropped before reaching your org.
Parameter sanitization
The server scans all string inputs and removes characters that could introduce command-injection risks before passing data to the Okta API.
Least-privilege access control
Every action maps to the authenticated user's OAuth scopes, so the AI agent can access only explicitly authorized tools and APIs. Short-lived tokens from OIDC or API service integration link every action to an identity and limit exposure from long-lived credentials.

Architecture overview and how the server works

How it works

Incoming requests follow this path:

  1. An Okta admin or end user types a request into an MCP client such as VS Code.
  2. The MCP client connects the LLM to the Okta Managed MCP Server over HTTPS. The client handles the MCP protocol, including server discovery, authorization, and error handling.
  3. The MCP client sends the request securely over HTTPS to the Okta Managed MCP Server.
  4. The Okta Managed MCP Server verifies the OIDC session, checks the OAuth scopes, and validates all inputs against tool schemas.
  5. The Okta Managed MCP Server identifies the relevant Okta API, executes the operation, and retrieves the result.
  6. The Okta Managed MCP Server removes extra response fields from the Okta API response and returns a clean, concise result to the MCP client.

Architecture overview

The Okta Managed MCP Server handles all processing in the Okta cloud, so nothing runs on your local machine. When you type a prompt, your MCP client sends it securely over HTTPS to the Okta Managed MCP Server. The Okta Managed MCP Server validates your credentials, checks inputs against tool schemas, calls the relevant Okta APIs, and returns an optimized response to your MCP client.

The Okta Managed MCP Server limits API calls to protect your org from excessive requests. Okta's general API rate limits apply alongside the Okta Managed MCP Server endpoint rate limit of 100 requests per minute, per org. Your requests must stay within both limits, and whichever limit is reached first applies. If a client sends too many calls in a short period, the server returns an HTTP 429 response. For details on Okta's general API rate limits, see Rate limits.

Diagram showing the request flow from an MCP client through the Okta Managed MCP Server to Okta APIs.
Figure 1. Okta Managed MCP Server architecture