API ReferenceMCP

List all instances for an MCP serverv3.1

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

Retrieves a paginated list of user instances (user IDs) associated with a specific Model Control Protocol (MCP) server. This endpoint supports pagination to handle servers with many instances.

Authorization

ApiKeyAuth
x-api-key<token>

Project API key authentication

In: header

Path Parameters

serverIdstringRequired

The ID of the MCP server

Query Parameters

page_nonullable number

Page number for pagination (1-based)

Default: 1
limitnullable number

Number of items per page (default: 20)

Default: 20
searchstring

Search instances by user ID/instance ID

order_byenum

Field to order results by

Default: "updated_at"
Possible values:
created_atupdated_at
order_directionenum

Direction of ordering

Default: "desc"
Possible values:
ascdesc

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v3.1/mcp/servers/550e8400-e29b-41d4-a716-446655440000/instances"
{  "instances": [    {      "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"    }  ],  "server_id": "550e8400-e29b-41d4-a716-446655440000",  "server_name": "Production GitHub Integration",  "total_pages": 3,  "current_page": 1}
Edit this page on GitHub