Skip to main content

​
list_conversations

List conversations with optional filters and pagination. Parameters:
​
agentId
string
Filter conversations by agent ID.
​
search
string
Search within message content.
​
limit
number
Max results to return. Defaults to 20, max 50.
​
offset
number
Pagination offset. Defaults to 0.
Example request: 
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_conversations",
    "arguments": {
      "agentId": "abc-123",
      "limit": 10
    }
  },
  "id": 1
}
Example response: 
{
  "conversations": [
    {
      "id": "conv-456",
      "agentId": "abc-123",
      "status": "resolved",
      "messagePreview": "How do I reset my password?",
      "messageCount": 6,
      "createdAt": "2025-02-01T09:15:00Z",
      "updatedAt": "2025-02-01T09:22:00Z"
    }
  ],
  "total": 42
}

​
get_conversation

Get a single conversation with its full message history. Parameters:
​
conversationId
string
required
The ID of the conversation to retrieve.
Example request: 
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_conversation",
    "arguments": {
      "conversationId": "conv-456"
    }
  },
  "id": 2
}
Example response: 
{
  "id": "conv-456",
  "agentId": "abc-123",
  "status": "resolved",
  "createdAt": "2025-02-01T09:15:00Z",
  "messages": [
    {
      "id": "msg-1",
      "role": "user",
      "content": "How do I reset my password?",
      "createdAt": "2025-02-01T09:15:00Z"
    },
    {
      "id": "msg-2",
      "role": "assistant",
      "content": "You can reset your password by clicking...",
      "createdAt": "2025-02-01T09:15:02Z"
    }
  ]
}