MCP

List MCP servers with optional filters and pagination

Changed on

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.

get/api/v3.1/mcp/servers

Request

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

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. 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_1McpServers removed and replaced with getMcpServers

    • info

      api tag Servers removed

    • info

      endpoint deprecated

  • c4fb53d0473dRevision changes
    • info

      added the non-success response with the status