List MCP servers for a specific app

1 import requests 2 3 url = "https://backend.composio.dev/api/v3/mcp/app/github" 4 5 querystring = {"name":"github","toolkit":"github","auth_config_id":"auth_cfg_abc123def456","page_no":"1","limit":"10"} 6 7 headers = {"x-api-key": "<x-api-key>"} 8 9 response = requests.get(url, headers=headers, params=querystring) 10 11 print(response.json())

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 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)

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 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_pagesstring

Total number of pages in the paginated response

current_pagestring

Current page number being returned

Path parameters

Headers

Query parameters

Response