> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inboxmate.psquared.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversations

> List and retrieve chat conversations via the MCP API.

## list\_conversations

List conversations with optional filters and pagination.

**Parameters:**

<ParamField body="agentId" type="string">
  Filter conversations by agent ID.
</ParamField>

<ParamField body="search" type="string">
  Search within message content.
</ParamField>

<ParamField body="limit" type="number">
  Max results to return. Defaults to 20, max 50.
</ParamField>

<ParamField body="offset" type="number">
  Pagination offset. Defaults to 0.
</ParamField>

**Example request:**

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_conversations",
    "arguments": {
      "agentId": "abc-123",
      "limit": 10
    }
  },
  "id": 1
}
```

**Example response:**

```json theme={null}
{
  "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:**

<ParamField body="conversationId" type="string" required>
  The ID of the conversation to retrieve.
</ParamField>

**Example request:**

```json theme={null}
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_conversation",
    "arguments": {
      "conversationId": "conv-456"
    }
  },
  "id": 2
}
```

**Example response:**

```json theme={null}
{
  "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"
    }
  ]
}
```