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

object

String

id

String

Unique identifier for the session message

type

Enum

Type of the session message

sender

Object

Information about the sender of the message

mcp_message

Object

Details of the MCP message

session_id

String

Identifier for the related session

server_session_id

String

Identifier for the related server session

created_at

Date

Timestamp when the message was created

{
  "object": "session.message",
  "type": "request",
  "sender": {
    "object": "session.message.sender",
    "type": "client"
  },
  "mcp_message": {
    "object": "session.message.mcp_message",
    "payload": {}
  }
}

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