List MCP servers with optional filters and pagination

1 curl -G https://backend.composio.dev/api/v3/mcp/servers \ 2 -H "x-api-key: <x-api-key>" \ 3 -d name=github \ 4 -d toolkit=github \ 5 -d auth_config_id=auth_cfg_abc123def456 \ 6 -d page_no=1 \ 7 -d limit=10

1 { 2 "items": [ 3 { 4 "id": "550e8400-e29b-41d4-a716-446655440000", 5 "name": "GitHub Integration Server", 6 "auth_config_id": "auth_cfg_abc123def456", 7 "allowed_tools": [ 8 "foo" 9 ], 10 "mcp_url": "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?transport=sse", 11 "commands": { 12 "cursor": "npx @composio/mcp@latest setup \"https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000\" --client cursor", 13 "claude": "npx @composio/mcp@latest setup \"https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000\" --client claude", 14 "windsurf": "npx @composio/mcp@latest setup \"https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000\" --client windsurf" 15 }, 16 "updated_at": "2023-06-15T14:30:00.000Z", 17 "created_at": "2023-06-10T09:15:00.000Z" 18 } 19 ], 20 "total_pages": "5", 21 "current_page": "1" 22 }

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

namestringOptional

Filter MCP servers by name (case-insensitive partial match)

toolkitstringOptional

Filter MCP servers by toolkit slug

auth_config_idstringOptional

Filter MCP servers by authentication configuration ID

page_nointegerOptionalDefaults to 1

Page number for pagination (1-based)

limitintegerOptionalDefaults to 10

Number of items per page (default: 10)

Response

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

itemslist of objects

Array of MCP server configurations

total_pagesstring

Total number of pages in the paginated response

current_pagestring

Current page number being returned

Headers

Query parameters

Response