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

name?string

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

toolkits?string

Comma-separated list of toolkit slugs to filter servers by

auth_config_ids?string

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

order_by?string

Field to order results by

Default"updated_at"
Value in"created_at" | "updated_at"
order_direction?string

Direction of ordering

Default"desc"
Value in"asc" | "desc"
page_no?number|null

Page number for pagination (1-based)

Default1
limit?number|null

Number of items per page (default: 10)

Default10

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"
    ]
  }
}