Skip to content
/
Create a virtual MCP

Create a virtual MCP

Request

OAuth 2.0 scope:
  • okta.resourceServers.virtualMcpServers.manage
Admin roles:
  • SUPER_ADMIN

Creates a virtual MCP

Bodyapplication/jsonrequired
profileobjectrequired
resourcePathstring, [ 1 .. 64 ] characters^[a-zA-Z0-9\-._~]+$required

A URI path suffix that uniquely identifies this virtual MCP

Example:"production"
POST
/workload-principals/api/v1/virtual-mcp-servers
curl -i -X POST \
  https://subdomain.okta.com/workload-principals/api/v1/virtual-mcp-servers \
  -H 'Content-Type: application/json' \
  -d '{
    "resourcePath": "production",
    "profile": {
      "displayName": "Production MCP Servers",
      "description": "Groups all production MCP servers for the engineering team"
    }
  }'

Responses

Accepted

Headers
Locationstring, (uri)required

URL to poll for operation status. See AI Agent Operations.

Example:"https://{yourOktaDomain}/workload-principals/api/v1/operations/op-1a2b3c4d"
Response
No content