Skip to main content
GET
/
mcp-servers
/
{mcpServerId}
/
connections
List MCP Server Connections
curl --request GET \
  --url https://api.portkey.ai/v1/mcp-servers/{mcpServerId}/connections \
  --header 'x-portkey-api-key: <api-key>'
{
  "data": [
    {
      "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "connected": true,
      "created_at": "2023-11-07T05:31:56Z",
      "last_updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "total": 123,
  "has_more": true
}

Authorizations

​
x-portkey-api-key
string
header
required

Path Parameters

​
mcpServerId
string
required

MCP Server ID (UUID) or slug

Query Parameters

​
user_id
string

Optional. UUID of the user whose connections to list. If not provided, defaults to the current user for user API keys, and returns all connections on the MCP server for service API keys.

​
workspace_id
string

Workspace ID or slug. Required when using org admin API key; optional when API key is workspace-scoped.

​
current_page
integer
default:0
Required range: x >= 0
​
page_size
integer
default:100
Required range: 1 <= x <= 500

Response

200 - application/json

OK

​
data
object[]
​
total
integer
​
has_more
boolean
Last modified on April 14, 2026