API ReferenceMCP

Create a new MCP server instance

Markdown
POST
/api/v3/mcp/servers/{serverId}/instances

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.

Authorization

ApiKeyAuth
x-api-key<token>

API key authentication

In: header

Path Parameters

serverId*string

The ID of the MCP server

Request Body

application/json

user_id*string

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

Length1 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://backend.composio.dev/api/v3/mcp/servers/550e8400-e29b-41d4-a716-446655440000/instances" \  -H "Content-Type: application/json" \  -d '{    "user_id": "user_123456"  }'
{
  "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"
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}