MCP

List MCP servers for a specific app

Changed on

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.

get/api/v3.1/mcp/app/{appKey}

Request

  • Base URL
    https://backend.composio.dev
  • URL
    https://backend.composio.dev/api/v3.1/mcp/app/{appKey}
  • Auth
    API key in header x-api-key

Path parameters

appKeystring required

Toolkit or application slug identifier to filter MCP servers by

Example:github

The key of the app to find MCP servers for

Query parameters

namestring

Name substring to filter servers by

Example:github

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

toolkitsstring

Comma-separated list of toolkit slugs to filter servers by

auth_config_idsstring

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

order_by'created_at' | 'updated_at'

Field to use for ordering the results

Example:updated_at

Field to order results by

order_direction'asc' | 'desc'

Sort direction (ascending or descending)

Example:desc

Direction of ordering

page_nointeger

Page number to retrieve

Example:1

Page number for pagination (1-based)

limitinteger

Number of servers to return per page

Example: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.

total_pagesnumber required

Total number of pages in the paginated response

current_pagenumber required

Current page number being returned

Example response

{
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "GitHub Integration Server",
      "auth_config_ids": [
        "ac_1a2b3c4d5e6f",
        "ac_7g8h9i0j1k2l"
      ],
      "allowed_tools": [
        "GITHUB_CREATE_AN_ISSUE",
        "GITHUB_GET_A_REPOSITORY"
      ],
      "mcp_url": "https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john",
      "commands": {
        "cursor": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client cursor",
        "claude": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client claude",
        "windsurf": "npx @composio/mcp@latest setup \"https://backend.composio.dev/v3/mcp/550e8400-e29b-41d4-a716-446655440000?user_id=john\" --client windsurf"
      },
      "toolkits": [
        "github",
        "jira",
        "slack"
      ],
      "toolkit_icons": {
        "github": "https://assets.composio.dev/logos/github.png",
        "jira": "https://assets.composio.dev/logos/jira.png",
        "slack": "https://assets.composio.dev/logos/slack.png"
      },
      "updated_at": "2023-06-15T14:30:00.000Z",
      "created_at": "2023-06-10T09:15:00.000Z",
      "server_instance_count": 5,
      "managed_auth_via_composio": true
    }
  ],
  "total_pages": 5,
  "current_page": 1
}

Changes

  • 98956f31abf3Revision changes
    • breaking

      for the query request parameter limit, the type changed from number to integer

    • breaking

      for the query request parameter page_no, the type changed from number to integer

    • warning

      for the query request parameter limit, the exclusiveMinimum was set to true

    • warning

      for the query request parameter page_no, the exclusiveMinimum was set to true

    • warning

      for the query request parameter limit, the min was set to 0.00

    • warning

      for the query request parameter page_no, the min was set to 0.00

    • info

      api operation id getV3_1McpAppByAppKey removed and replaced with getMcpAppByAppKey

    • info

      api tag Applications removed

    • info

      api tag Servers removed

    • info

      endpoint deprecated

  • 589a7d115a5eRevision changes
    • info

      the endpoint scheme security CookieAuth was removed from the API

    • info

      the endpoint scheme security UserApiKeyAuth was removed from the API