Skip to main content
Get the current read cursor and unread count for the authenticated user in a conversation.

Tool details

FieldValue
Nameget_conversation_read_state
GroupConversations

Playground

Input schema

Input schema
{
  "type": "object",
  "properties": {
    "conversation_id": {
      "type": "string",
      "format": "uuid",
      "description": "Conversation identifier that scopes the request."
    }
  },
  "required": [
    "conversation_id"
  ],
  "additionalProperties": false,
  "description": "Input schema for the get_conversation_read_state tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

Output schema
{
  "type": "object",
  "properties": {
    "conversation_id": {
      "type": "string",
      "description": "Conversation identifier."
    },
    "last_read_message_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "Most recent message marked as read in the conversation."
    },
    "unread_count": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of unread messages for the current participant."
    }
  },
  "required": [
    "conversation_id",
    "last_read_message_id",
    "unread_count"
  ],
  "additionalProperties": false,
  "description": "Read-state summary for one conversation.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}