v63

latestOpenAPI 3.0.0Proprietaryraw.githubusercontent.com2026-08-0110571.8 MB
MCP
Servers
Instances

Create a new MCP server instance

Creates a new instance for a Model Control Protocol (MCP) server. This endpoint validates that the user has connected accounts for all auth configurations associated with the MCP server before creating the instance.

post/api/v3.1/mcp/servers/{serverId}/instances

Path parameters

serverIdstring required

UUID of the MCP server to create an instance for

Example:550e8400-e29b-41d4-a716-446655440000

The ID of the MCP server

Request body

user_idstring required

The user ID (entity ID) that will be used as both the user identifier and instance ID

Example request

{
  "user_id": "user_123456"
}

Response

Successfully created MCP server instance. Returns the created instance details.

idstring required

UUID of the instance record

instance_idstring required

The instance identifier (same as the user_id)

mcp_server_idstring required

UUID of the parent MCP server

created_atstring required

Date and time when this instance was created

updated_atstring required

Date and time when this instance was last modified

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "instance_id": "user_123456",
  "mcp_server_id": "660e8400-e29b-41d4-a716-446655440001",
  "created_at": "2023-06-10T09:15:00.000Z",
  "updated_at": "2023-06-15T14:30:00.000Z"
}