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

status

String

Connection status

connection_state

String

Connection state

transport

String

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

Date

Timestamp when last active

{
  "object": "session.connection",
  "id": "scn_8hJkLmNpQrStUvWx",
  "status": "active",
  "connection_state": "connected",
  "transport": "mcp",
  "usage": {},
  "mcp": {
    "capabilities": {},
    "protocol_version": "2024-11-05",
    "transport": "sse"
  },
  "session_id": "ses_4dEfGhJkLmNpQrSt",
  "participant": {
    "object": "session.participant",
    "id": "spt_5eFgHjKlMnPqRsTu",
    "type": "unknown",
    "identifier": "claude-desktop",
    "name": "Claude Desktop",
    "data": {
      "client_version": "1.2.3"
    },
    "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

Maximum number of items to return (1-100)

after

StringOptional

Return items after this ID

before

StringOptional

Return items before this ID

cursor

StringOptional

Pagination cursor from a previous response

order

EnumOptional

Sort order for results

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)

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_..."