list_conversations MCP Tool

The list_conversations MCP tool provides a paginated list of conversation summaries for an authenticated site. Its primary purpose is to allow clients to discover which conversations exist, rather than to read the contents of individual conversations.

Results are ordered by the last_appended_at timestamp in descending order (most recently active first), with ties broken by ascending conversation_id for deterministic paging.

To read the contents of a conversation, use recall_memory for recent items or replay_memory to reconstruct the full log from a specific position.

This tool requires Basic authentication.

Request: ListConversationsRequest

{
  "cursor": "string",
  "limit": 50
}

Field	Type	Description	Default
cursor	string?	An opaque continuation token from a previous response’s next_cursor; omit to start from the most recently active conversation.	null
limit	uint64	Maximum number of conversations to return in one call. Defaults to 50. The maximum allowed value is 1000.	50

Response: ListConversationsResponse

{
  "conversations": [
    {
      "conversation_id": "string",
      "created_at": "string",
      "last_appended_at": "string"
    }
  ],
  "next_cursor": "string"
}

Field	Type	Description
conversations	array<McpConversationSummary>	The next conversations of your site’s listing, ordered most-recently-active first. Each entry carries only its id and timestamps, never stored items.
next_cursor	string?	Opaque token to pass back as cursor to continue the listing; null once the listing is exhausted.

McpConversationSummary

Field	Type	Description
conversation_id	string	The pseudonymous conversation id, exactly as minted by the client.
created_at	string	When the conversation’s first item was recorded, as an RFC3339 timestamp.
last_appended_at	string	When the conversation’s most recent item was recorded, as an RFC3339 timestamp — the field the list is ordered by, most recent first.