Session Connection

Each time a new MCP connection to a server is established, a session connection is created. This allows you to track and manage the connections made during a session.

Session Connection object

Attributes

items

Object
{
  "items": {
    "0": {
      "object": "session.session_connection",
      "status": "active",
      "mcp": {
        "object": "mcp",
        "connection_type": "sse",
        "client": {
          "object": "session.session_connection.client",
          "capabilities": {}
        },
        "server": {
          "object": "session.session_connection.server",
          "capabilities": {}
        }
      },
      "usage": {},
      "server": {
        "object": "server#preview",
        "type": "public"
      },
      "session": {
        "object": "session#preview",
        "status": "active",
        "connection_status": "connected",
        "usage": {},
        "metadata": {}
      },
      "server_deployment": {
        "object": "server.server_deployment#preview",
        "metadata": {},
        "server": {
          "object": "server#preview",
          "type": "public"
        }
      }
    },
    "object": "example_object",
    "id": "example_id",
    "status": "",
    "mcp": {
      "object": "example_object",
      "version": "example_version",
      "connection_type": "",
      "client": {
        "object": "example_object",
        "name": "example_name",
        "version": "example_version",
        "capabilities": "example_capabilities"
      },
      "server": {
        "object": "example_object",
        "name": "example_name",
        "version": "example_version",
        "capabilities": "example_capabilities"
      }
    },
    "usage": {
      "total_productive_message_count": 0,
      "total_productive_client_message_count": 0,
      "total_productive_server_message_count": 0
    },
    "server": {
      "object": "example_object",
      "id": "example_id",
      "name": "example_name",
      "description": "example_description",
      "type": "",
      "created_at": "2025-10-15T16:41:27.109Z",
      "updated_at": "2025-10-15T16:41:27.109Z"
    },
    "session": {
      "object": "example_object",
      "id": "example_id",
      "status": "",
      "connection_status": "",
      "usage": {
        "total_productive_message_count": 0,
        "total_productive_client_message_count": 0,
        "total_productive_server_message_count": 0
      },
      "metadata": "example_metadata",
      "created_at": "2025-10-15T16:41:27.109Z",
      "updated_at": "2025-10-15T16:41:27.109Z"
    },
    "server_deployment": {
      "object": "example_object",
      "id": "example_id",
      "name": "example_name",
      "description": "example_description",
      "metadata": "example_metadata",
      "created_at": "2025-10-15T16:41:27.109Z",
      "updated_at": "2025-10-15T16:41:27.109Z",
      "server": {
        "object": "example_object",
        "id": "example_id",
        "name": "example_name",
        "description": "example_description",
        "type": "",
        "created_at": "2025-10-15T16:41:27.109Z",
        "updated_at": "2025-10-15T16:41:27.109Z"
      }
    },
    "created_at": "2025-10-15T16:41:27.109Z",
    "started_at": "2025-10-15T16:41:27.110Z",
    "ended_at": "2025-10-15T16:41:27.110Z"
  },
  "pagination": {
    "has_more_before": false,
    "has_more_after": false
  }
}

List session connections

List all session connections

URL Parameters

session_id

String

The unique identifier for the session

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

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

Get session connection

Get the information of a specific session connection

URL Parameters

session_id

String

The unique identifier for the session

session_connection_id

String

The unique identifier for the session_connection

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