COcomposiohq
MCP
Servers
Instances

Create a new MCP server instance

Changed on

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/mcp/servers/{serverId}/instances

Request

  • Base URL
    https://backend.composio.dev
  • URL
    https://backend.composio.dev/api/v3/mcp/servers/{serverId}/instances
  • Auth
    API key in header x-api-key

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"
}

Changes