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.

Path parameters

serverIdstringRequired

The ID of the MCP server

Headers

x-api-keystringRequired

Request

This endpoint expects an object.

user_idstringRequired>=1 character

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

Response

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

idstring

UUID of the instance record

instance_idstring

The instance identifier (same as the user_id)

mcp_server_idstring

UUID of the parent MCP server

created_atstring

Date and time when this instance was created

updated_atstring

Date and time when this instance was last modified

1	import requests
2
3	url = "https://backend.composio.dev/api/v3/mcp/servers/550e8400-e29b-41d4-a716-446655440000/instances"
4
5	payload = { "user_id": "user_123456" }
6	headers = {
7	"x-api-key": "<apiKey>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.post(url, json=payload, headers=headers)
12
13	print(response.json())

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

Path parameters

Headers

Request

Response

Errors