Check a user's connected accounts for a server

POST/api/v1/mcp/configs/{config_id}/connected_accounts

Returns the user's connected account on each connection the server uses, with its status. Call it before you mint a session token, and send the user the authorization link for any account that isn't ACTIVE. With include_auth_link set to true, the call creates any account the user doesn't have yet and returns a fresh authorization link for every connection, in authentication_link. Without it, nothing is created, and a connection where the user has no account comes back with an empty connected_account_id.

This page as markdown Virtual MCP servers overview

Authorization

Authorization: Bearer $TOKEN, an access token from the client credentials grant. See Authentication.

Path parameters

config_idstringrequired

ID of the MCP configuration

Body

identifierstringrequired

Your app's ID for the user, the same value you used when the user connected. Use a stable internal ID, not an email address.

include_auth_linkboolean

Set to true to get a fresh authorization link for every connection, creating any connected account the user doesn't have yet.

scalekit_client.actions.mcp.list_mcp_connected_accounts

Lists the user's connected account on each connection a Virtual MCP server uses. Returns each account's status and, with include_auth_link=True, an authorization link the user opens to connect or reconnect. Call it before you mint a session token.

scalekit_client.actions.mcp.list_mcp_connected_accounts(
    config_id: str,
    identifier: str,
    include_auth_link: Optional[bool] = None,
) -> ListMcpConnectedAccountsResponse

Parameters

config_idstrrequired

Scalekit ID of the MCP configuration to inspect, e.g. "cfg_01abc123".

identifierstrrequired

Your app's ID for the user, the same value you used when the user connected. Use a stable internal ID, not an email address.

include_auth_linkOptional[bool]

Set to true to get a fresh authorization link for every connection, creating any connected account the user doesn't have yet.

Returns ListMcpConnectedAccountsResponse: One entry per connection in connected_accounts, with connection_name, provider, connected_account_id, connected_account_status, such as ACTIVE or PENDING_AUTH, and authentication_link, the authorization link when you set include_auth_link.

From scalekit-sdk-python 2.19.1.

scalekit.actions.mcp.listConnectedAccounts

Lists the connected accounts backing a configuration for one user. Call this before minting a session token: OAuth credentials can expire or be revoked at any time, and an agent that starts without an active connection fails on every tool call. Surface authenticationLink for any account whose connectedAccountStatus is not "ACTIVE".

scalekit.actions.mcp.listConnectedAccounts(
  params: {
    configId: string;
    identifier: string;
    includeAuthLink?: boolean;
  },
): Promise<ListMcpConnectedAccountsResponse>

Parameters

configIdstringrequired

ID of the configuration.

identifierstringrequired

Your app's ID for the user, the same value you used when the user connected. Use a stable internal ID, not an email address.

includeAuthLinkboolean

Set to true to get a fresh authorization link for every connection, creating any connected account the user doesn't have yet.

Returns Promise<ListMcpConnectedAccountsResponse>.

From @scalekit-sdk/node 2.18.0.

Response 200

connected_accountsarray of object

Connected account state for each connection in the configuration

Show 6 child attributes

authentication_linkstring

The authorization link for this connection. Empty unless the request set include_auth_link.

connected_account_idstring

The user's connected account on this connection. Empty when the user has none.

connected_account_statusstring

The account's status, such as ACTIVE or PENDING_AUTH. Empty when the user has no account.

connection_idstring

ID of the connection

connection_namestring

Name of the connection

providerstring

The app, such as GITHUB.

Errors

Every error has the same body: code, message and details. See Errors and rate limits.

400Bad request - config_id or identifier is missing or invalid

404Not found - no MCP configuration exists with the given config_id

Used in

Request

curl -sS -X POST \
  "$SCALEKIT_ENVIRONMENT_URL/api/v1/mcp/configs/cfg_85630864460904897/connected_accounts" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "identifier": "user_123",
    "include_auth_link": true
  }'

result = scalekit_client.actions.mcp.list_mcp_connected_accounts(
    config_id="cfg_85630864460904897",
    identifier="user_123",
    include_auth_link=True,
)

const result = await scalekit.actions.mcp.listConnectedAccounts({
  configId: "cfg_85630864460904897",
  identifier: "user_123",
  includeAuthLink: true,
});

Response 200

{
  "connected_accounts": [
    {
      "connection_id": "conn_70219645518267719",
      "connection_name": "github-connect",
      "provider": "GITHUB",
      "connected_account_id": "ca_24834495392091352",
      "connected_account_status": "PENDING_AUTH",
      "authentication_link": "https://your-env.scalekit.dev/magicLink/7f0c2b9e-4d1a-4c3e-9b8f-2a6d5e1c3f40_o"
    }
  ]
}