List MCP servers with optional filters and pagination

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

1 { 2 "items": [ 3 { 4 "id": "550e8400-e29b-41d4-a716-446655440000", 5 "name": "GitHub Integration Server", 6 "auth_config_ids": [ 7 "auth_cfg_abc123def456", 8 "auth_cfg_xyz789" 9 ], 10 "allowed_tools": [ 11 "github-issues", 12 "github-repos" 13 ], 14 "mcp_url": "https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000?transport=sse", 15 "toolkits": [ 16 "github", 17 "jira", 18 "slack" 19 ], 20 "commands": { 21 "cursor": "npx @composio/mcp@latest setup \"https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000\" --client cursor", 22 "claude": "npx @composio/mcp@latest setup \"https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000\" --client claude", 23 "windsurf": "npx @composio/mcp@latest setup \"https://mcp.composio.dev/composio/server/550e8400-e29b-41d4-a716-446655440000\" --client windsurf" 24 }, 25 "updated_at": "2023-06-15T14:30:00.000Z", 26 "created_at": "2023-06-10T09:15:00.000Z", 27 "managed_auth_via_composio": true 28 } 29 ], 30 "total_pages": "5", 31 "current_page": "1" 32 }

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)

toolkitsstringOptional

Comma-separated list of toolkit slugs to filter servers by

auth_config_idsstringOptional

Comma-separated list of auth config IDs to filter servers by

page_nodoubleOptionalDefaults to 1

Page number for pagination (1-based)

limitdoubleOptionalDefaults 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

List MCP servers with optional filters and pagination

Headers

Query parameters

Response

Errors