List MCP servers for a specific app

1 from composio_client import Composio 2 3 client = Composio( 4 api_key="My API Key", 5 ) 6 response = client.mcp.retrieve_app( 7 app_key="github", 8 ) 9 print(response.current_page)

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 Model Control Protocol (MCP) servers that are configured for a specific application or toolkit. This endpoint allows you to find all MCP server instances that have access to a particular application, such as GitHub, Slack, or Jira.

Path parameters

appKeystringRequired

The key of the app to find MCP servers for

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 for the specified application. Returns a paginated list of server configurations including connection details and command instructions.

itemslist of objects

Array of MCP server configurations

total_pagesdouble

Total number of pages in the paginated response

current_pagedouble

Current page number being returned

List MCP servers for a specific app

Path parameters

Headers

Query parameters

Response

Errors