Session Message

When MCP servers and clients communicate, Metorial captures the messages they send. This allows you to see the raw messages exchanged between the server and client, which can be useful for debugging or understanding the communication flow.

Session Message object

Attributes

items

Object
{
  "items": {
    "0": {
      "object": "session.message",
      "type": "request",
      "sender": {
        "object": "session.message.sender",
        "type": "client"
      },
      "mcp_message": {
        "object": "session.message.mcp_message",
        "payload": {}
      }
    },
    "object": "example_object",
    "id": "example_id",
    "type": "",
    "sender": {
      "object": "example_object",
      "type": "",
      "id": "example_id"
    },
    "mcp_message": {
      "object": "example_object",
      "id": "example_id",
      "method": "example_method",
      "payload": "example_payload"
    },
    "session_id": "example_session_id",
    "server_session_id": "example_server_session_id",
    "created_at": "2025-10-15T16:41:26.979Z"
  },
  "pagination": {
    "has_more_before": false,
    "has_more_after": false
  }
}

List session messages

List all messages for a specific session

URL Parameters

session_id

String

The unique identifier for the session

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

server_run_id

UnionOptional

server_session_id

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

Get session message

Get details of a specific session message

URL Parameters

session_id

String

The unique identifier for the session

session_message_id

String

The unique identifier for the session_message

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