list_mcp_server_connections
List active connection records for a Portkey-managed MCP server, including user, connected state, and timestamps, to audit sessions or identify which user to disconnect.
Instructions
List active connection records for one Portkey-managed MCP server, including user, connected state, and connection timestamps. Use it to audit sessions or identify the user/workspace before disconnect_mcp_server_connection; service keys can list all users, while user keys default to their own user. Organisation admin keys must provide workspace_id. This reads live connection state and does not test upstream server reachability (use test_mcp_server for that).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "list_mcp_server_connections"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | MCP server ID or slug whose connections to list | |
| user_id | No | User UUID to filter; user-scoped keys default to their own user when omitted | |
| page_size | No | Connections per page, from 1 through 500; defaults to 100 | |
| current_page | No | Zero-based results page; defaults to 0 | |
| workspace_id | No | Workspace ID or slug; required with an organisation admin API key |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | Call succeeded | |
| data | No | Success payload | |
| error | No | Failure details |