> ## Documentation Index
> Fetch the complete documentation index at: https://gaia-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List MCP Servers

> Retrieves all MCP servers configured for a specific project

## Query Parameters

<ParamField query="projectId" type="string" required>
  Project ID to filter servers
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Whether the request was successful
</ResponseField>

<ResponseField name="servers" type="array">
  Array of MCP server objects

  <Expandable title="Server Object">
    <ResponseField name="id" type="string">
      Unique server identifier
    </ResponseField>

    <ResponseField name="projectId" type="string">
      Associated project ID
    </ResponseField>

    <ResponseField name="name" type="string">
      Server name
    </ResponseField>

    <ResponseField name="description" type="string | null">
      Server description
    </ResponseField>

    <ResponseField name="url" type="string | null">
      Server URL
    </ResponseField>

    <ResponseField name="transportType" type="string">
      Transport type: `stdio`, `http`, or `sse`
    </ResponseField>

    <ResponseField name="connectionType" type="string">
      Connection type: `direct` or `proxy`
    </ResponseField>

    <ResponseField name="status" type="string">
      Server status: `connecting`, `connected`, `disconnected`, or `error`
    </ResponseField>

    <ResponseField name="capabilities" type="object | null">
      Server capabilities
    </ResponseField>

    <ResponseField name="lastConnectedAt" type="string | null">
      ISO 8601 timestamp of last connection
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 timestamp of creation
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      ISO 8601 timestamp of last update
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.example.com/api/mcp/servers?projectId=proj_123" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.example.com/api/mcp/servers?projectId=proj_123',
    {
      method: 'GET',
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    }
  );

  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.example.com/api/mcp/servers',
      headers={'Authorization': 'Bearer YOUR_API_KEY'},
      params={'projectId': 'proj_123'}
  )

  data = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "success": true,
    "servers": [
      {
        "id": "mcp_abc123",
        "projectId": "proj_123",
        "name": "Production Server",
        "description": "Main production MCP server",
        "url": "https://mcp-server.example.com",
        "transportType": "http",
        "connectionType": "proxy",
        "status": "connected",
        "capabilities": {
          "tools": true,
          "resources": true,
          "prompts": true
        },
        "lastConnectedAt": "2026-01-17T10:30:00Z",
        "createdAt": "2026-01-01T00:00:00Z",
        "updatedAt": "2026-01-17T10:30:00Z"
      }
    ]
  }
  ```
</ResponseExample>