v2

latestOpenAPI 3.0.0Proprietary2026-08-07936826.0 KB

MCP

Servers

List MCP servers with optional filters and pagination

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/mcp/servers

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_nonumber nullable

Page number to retrieve

Example:1

Page number for pagination (1-based)

limitnumber nullable

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
}