Update conversation read state

veryfront__update_conversation_read_state

Access

No external-service connection is required. Use a Veryfront credential with access to the requested resources.

Call type: Can change resources.

Arguments

FieldTypeRequiredDescription and constraints
conversation_idstringYesConversation identifier that scopes the request. Format: uuid.
message_idstringYesAdvances the read cursor to this message; an older message does not move it backward. Format: uuid.

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "veryfront__update_conversation_read_state",
    "arguments": {
      "conversation_id": "00000000-0000-4000-8000-000000000000",
      "message_id": "00000000-0000-4000-8000-000000000000"
    }
  }
}

Result

The published output shape is summarized below. Inspect both the MCP response content and isError when handling a call.

FieldTypeRequiredDescription and constraints
last_read_message_idstring or nullYesMost recent message marked as read in the conversation.
unread_countintegerYesNumber of unread messages for the current participant. Minimum: 0.

Full schemas

json
{
  "type": "object",
  "properties": {
    "conversation_id": {
      "type": "string",
      "format": "uuid",
      "description": "Conversation identifier that scopes the request."
    },
    "message_id": {
      "type": "string",
      "format": "uuid",
      "description": "Advances the read cursor to this message; an older message does not move it backward."
    }
  },
  "required": [
    "conversation_id",
    "message_id"
  ],
  "additionalProperties": false,
  "description": "Arguments for the update_conversation_read_state tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}
json
{
  "type": "object",
  "properties": {
    "last_read_message_id": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid"
        },
        {
          "type": "null",
          "description": "The last read message id returned by the tool."
        }
      ],
      "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": [
    "last_read_message_id",
    "unread_count"
  ],
  "additionalProperties": false,
  "description": "Read-state summary for one conversation.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}