---
title: "List all instances for an MCP server"
method: GET
path: "/api/v3.1/mcp/servers/{serverId}/instances"
tags: ["MCP", "Servers", "Instances"]
---

# List all instances for an MCP server

`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.

## Path parameters

- `serverId` string, required — UUID of the MCP server to list instances for

## Query parameters

- `page_no` number, nullable — Page number to retrieve
- `limit` number, nullable — Number of instances to return per page
- `search` string — Filter instances by user ID or instance ID (partial match)
- `order_by` 'created_at' | 'updated_at' — Field to use for ordering the results
- `order_direction` 'asc' | 'desc' — Sort direction (ascending or descending)

## Response `200`

Successfully retrieved MCP server instances. Returns the list of user IDs associated with this server.

- object — Paginated list of instances for an MCP server
  - `instances` object[], required — List of instance objects associated with this MCP server for the current page
    - `id` string, required — UUID of the instance record
    - `instance_id` string, required — The instance identifier (same as the user_id)
    - `mcp_server_id` string, required — UUID of the parent MCP server
    - `created_at` string, required — Date and time when this instance was created
    - `updated_at` string, required — Date and time when this instance was last modified
  - `server_id` string, required — UUID of the MCP server
  - `server_name` string, required — Name of the MCP server
  - `total_pages` number, required — Total number of pages in the paginated response
  - `current_page` number, required — Current page number being returned

## Other responses

- `400` — Bad request. The server ID parameter may be invalid.
- `401` — Unauthorized. Authentication is required or the provided credentials are invalid.
- `404` — MCP server not found. No server with the specified ID exists.
- `500` — Internal server error. An unexpected error occurred while processing the request.

---

[API](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/versions/4239836857f8/schema)