---
title: "List MCP servers with optional filters and pagination"
method: GET
path: "/api/v3.1/mcp/servers"
tags: ["MCP", "Servers"]
---

# List MCP servers with optional filters and pagination

`GET /api/v3.1/mcp/servers`

Retrieves a paginated list of MCP servers associated with the authenticated project. Results can be filtered by name, toolkit, or authentication configuration ID. MCP servers are used to provide Model Control Protocol integration points for connecting AI assistants to your applications and services.

## Query parameters

- `name` string — Name substring to filter servers by
- `toolkits` string
- `auth_config_ids` string
- `order_by` 'created_at' | 'updated_at' — Field to use for ordering the results
- `order_direction` 'asc' | 'desc' — Sort direction (ascending or descending)
- `page_no` number, nullable — Page number to retrieve
- `limit` number, nullable — Number of servers to return per page

## Response `200`

Successfully retrieved MCP servers. Returns a paginated list of server configurations including connection details and command instructions.

- object — Paginated response containing MCP servers
  - `items` object[], required — Array of MCP server configurations
    - `id` string, required — UUID of the MCP server instance
    - `name` string, required — User-defined descriptive name for this MCP server
    - `auth_config_ids` string[], required — ID references to the auth configurations used by this server
    - `allowed_tools` string[], required — Array of tool slugs that this MCP server is allowed to use
    - `mcp_url` string, required — [DEPRECATED] Please use the URL with user_id or connected_account_id query param
    - `toolkits` string[], required — Array of toolkit slugs that this MCP server is allowed to use
    - `toolkit_icons` object, required — Object mapping each toolkit slug to its icon/logo URL for display purposes
    - `commands` object, required — Set of command line instructions for connecting various clients to this MCP server
      - `cursor` string, required — Command line instruction for Cursor client setup
      - `claude` string, required — Command line instruction for Claude client setup
      - `windsurf` string, required — Command line instruction for Windsurf client setup
    - `updated_at` string, required — Date and time when this server configuration was last modified
    - `created_at` string, required — Date and time when this server was initially created
    - `server_instance_count` number, required — Total count of active user instances connected to this server
    - `managed_auth_via_composio` boolean, required — Whether the MCP server is managed by Composio
  - `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 query parameters may be invalid or in an incorrect format.
- `401` — Unauthorized. Authentication is required or the provided credentials are invalid.
- `403` — Forbidden. The authenticated user does not have permission to view MCP servers for this project.
- `404` — Not Found. One or more of the specified auth_config_ids do not exist or are not accessible to the authenticated user.
- `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)