---
title: "List Connections"
method: GET
path: "/api/v1/mcp_server_connections"
tags: ["MCP Servers"]
---

# List Connections

`GET /api/v1/mcp_server_connections`

ListConnections returns per-user MCP servers the calling user can
 connect to, filtered to apps where the user has an account. Covers
 OAuth2 authorization-code passthrough as well as bearer-token /
 custom-header per-user methods. Includes per-user connection status.

## Query parameters

- `page_size` integer — Page size (max 100).
- `page_token` string — Page token for pagination.

## Response `200`

MCPServerServiceListConnectionsResponse returns a list of passthrough-mode
 MCP servers with per-user connection status.

- C1ApiAiGovernanceV1MCPServerServiceListConnectionsResponse — MCPServerServiceListConnectionsResponse returns a list of passthrough-mode MCP servers with per-user connection status.
  - `list` C1ApiAiGovernanceV1MCPConnectionView[], nullable — List of passthrough MCP servers with connection status.
    - `appId` string — App that owns this MCP server.
    - `authMethod` 'MCP_SERVER_AUTH_METHOD_UNSPECIFIED' | 'MCP_SERVER_AUTH_METHOD_NONE' | 'MCP_SERVER_AUTH_METHOD_BEARER_TOKEN' | 'MCP_SERVER_AUTH_METHOD_OAUTH2' | 'MCP_SERVER_AUTH_METHOD_CUSTOM_HEADER' | 'MCP_SERVER_AUTH_METHOD_AWS_SIGV4' | 'MCP_SERVER_AUTH_METHOD_BASIC_AUTH' — Auth method on the connector. Drives the FE connect-flow choice: OAUTH2 → redirect via CreateAuthorizeURL; BEARER_TOKEN / CUSTOM_HEADER → form dialog via SubmitUserCredential.
    - `authorizedAsEmail` string — Email of the external identity (from OAuth ID token). Empty for non-OAuth connections (no upstream identity to surface).
    - `authorizedAsName` string — Display name of the external identity (from OAuth ID token). Empty for non-OAuth connections.
    - `connected` boolean — Whether the calling user has an active credential.
    - `connectedAt` string, date-time, nullable
    - `connectorId` string — MCP server connector ID.
    - `description` string — Description of the MCP server.
    - `displayName` string — Display name of the MCP server.
    - `serverType` 'MCP_SERVER_TYPE_UNSPECIFIED' | 'MCP_SERVER_TYPE_HOSTED' | 'MCP_SERVER_TYPE_EXTERNAL' — Server type (hosted or external).
  - `nextPageToken` string — Token for next page.

---

[API](https://skmtc.net/conductorone/apis/c1-api.md) · [All operations](https://skmtc.net/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/f2cf3228f366/schema)