API ReferenceMCP

List MCP servers with optional filters and pagination

Markdown
GET/api/v3/mcp/servers

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.

Authorization

ApiKeyAuth
x-api-key<token>

API key authentication

In: header

Query Parameters

namestring

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_byenum

Field to order results by

Default: "updated_at"
Possible values:
created_atupdated_at
order_directionenum

Direction of ordering

Default: "desc"
Possible values:
ascdesc
page_nonullable number

Page number for pagination (1-based)

Default: 1
limitnullable number

Number of items per page (default: 10)

Default: 10

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://backend.composio.dev/api/v3/mcp/servers"
{
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "GitHub Integration Server",
      "auth_config_ids": [
        "auth_cfg_abc123def456",
        "auth_cfg_xyz789"
      ],
      "allowed_tools": [
        "github-issues",
        "github-repos"
      ],
      "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
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}