Session Connections

Session connections represent the MCP connections established within a session. This read-only resource provides visibility into the connection state and capabilities.

Session Connections object

Attributes

object

String

String representing the object's type

id

String

Unique session connection identifier

connection_state

Enum

Connection state

transport

Enum

Transport protocol used

usage

Object

Usage statistics

mcp

ObjectNullable

MCP connection details

session_id

String

Parent session ID

participant

ObjectNullable

has_errors

Boolean

Whether the connection has any errors

has_warnings

Boolean

Whether the connection has any warnings

created_at

Date

Timestamp when created

last_message_at

Date

Timestamp of last message

last_active_at

DateNullable

Timestamp when last active

{
  "object": "session.connection",
  "id": "scn_8hJkLmNpQrStUvWx",
  "connection_state": "connected",
  "transport": "mcp",
  "usage": {},
  "mcp": {
    "capabilities": {},
    "protocol_version": "2024-11-05",
    "transport": "none"
  },
  "session_id": "ses_4dEfGhJkLmNpQrSt",
  "participant": {
    "object": "session.participant",
    "id": "spt_5eFgHjKlMnPqRsTu",
    "type": "unknown",
    "identifier": "claude-desktop",
    "name": "Claude Desktop",
    "data": {
      "identifier": "claude-desktop",
      "name": "Claude Desktop"
    },
    "provider_id": "pro_5gHjKlMnPqRsTuVw",
    "created_at": "2025-09-15T10:30:00.000Z"
  },
  "created_at": "2025-09-15T10:30:00.000Z",
  "last_message_at": "2025-09-15T10:30:00.000Z",
  "last_active_at": "2025-09-15T10:30:00.000Z"
}

List session connections

Returns a paginated list of connections for a session.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

status

UnionOptional

Filter by connection status

connection_state

UnionOptional

Filter by connection state

id

UnionOptional

Filter by session connection ID(s)

session_id

UnionOptional

Filter by session ID(s)

session_provider_id

UnionOptional

Filter by session provider ID(s)

participant_id

UnionOptional

Filter by participant ID(s)

created_at

ObjectOptional

Filter session connection creation time by date range

updated_at

ObjectOptional

Filter session connection last update time by date range

GEThttp://api.metorial.com/session-connections
curl -X GET "https://api.metorial.com/session-connections" \
  -H "Authorization: Bearer metorial_sk_..."

Get session connection

Retrieves a specific connection from a session.

URL Parameters

session_connection_id

String

The unique identifier for the session_connection

GEThttp://api.metorial.com/session-connections/:session_connection_id
curl -X GET "https://api.metorial.com/session-connections/ses_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."