Replai

List Inbox conversations

inbox_list

Read-onlyIdempotent

Reads bounded Workspace queue; cursors belong to this tenant and exact filter.

conversations_search finds an Agent's conversations by text, outcome or time.

Input Schema

Name	Required	Description	Default
`mode`	No	Reply-mode filter; null includes auto_reply, draft and handoff conversations.
`view`	No	Inbox queue view: attention, contact, no_reply, resolved or all.	attention
`limit`	No	Maximum number of Inbox conversations in this page.
`cursor`	No	next_cursor from inbox_list for the same Workspace, view and filters; null starts a page.
`channel`	No	Channel-type filter; null includes every channel type.
`agent_id`	No	Optional Agent ID from agents_list or agent_create; null includes all authorized Agents.

Output Schema

Name	Required	Description	Default
`items`	Yes
`next_cursor`	No
`attention_count`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedNov 4, 2026

addedOutput schema / $defs / InboxConversation / properties / last_message

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/MessagePreview"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

addedOutput schema / $defs / MessagePreview

Added value: +{
+  "properties": {
+    "content": {
+      "$ref": "#/$defs/MessagePreviewContent"
+    },
+    "message_type": {
+      "title": "Message Type",
+      "type": "string"
+    }
+  },
+  "required": [
+    "message_type",
+    "content"
+  ],
+  "title": "MessagePreview",
+  "type": "object"
+}

addedOutput schema / $defs / MessagePreviewContent

Added value: +{
+  "description": "Language-neutral display facts, never vendor payloads or media credentials.",
+  "properties": {
+    "address": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Address"
+    },
+    "event_type": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Event Type"
+    },
+    "media_type": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Media Type"
+    },
+    "quick_reply_label": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Quick Reply Label"
+    },
+    "text": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Text"
+    },
+    "title": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Title"
+    }
+  },
+  "title": "MessagePreviewContent",
+  "type": "object"
+}

Changed7 schema fields changedOct 30, 2026

changedInput schema / properties / agent_id / anyOf

Previous value: -[
-  {
-    "format": "uuid",
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "description": "Agent ID from agents_list or agent_create.",
+    "format": "uuid",
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

addedInput schema / properties / agent_id / description

Added value: +"Optional Agent ID from agents_list or agent_create; null includes all authorized Agents."

addedInput schema / properties / channel / description

Added value: +"Channel-type filter; null includes every channel type."

addedInput schema / properties / cursor / description

Added value: +"next_cursor from inbox_list for the same Workspace, view and filters; null starts a page."

addedInput schema / properties / limit / description

Added value: +"Maximum number of Inbox conversations in this page."

addedInput schema / properties / mode / description

Added value: +"Reply-mode filter; null includes auto_reply, draft and handoff conversations."

addedInput schema / properties / view / description

Added value: +"Inbox queue view: attention, contact, no_reply, resolved or all."

Changed2 schema fields changedOct 30, 2026

changedInput schema / properties / view / enum

Previous value: -[
-  "attention",
-  "contact",
-  "resolved",
-  "all"
-]New value: +[
+  "attention",
+  "contact",
+  "no_reply",
+  "resolved",
+  "all"
+]

changedOutput schema / $defs / InboxConversation / properties / inbox_views / items / enum

Previous value: -[
-  "attention",
-  "contact",
-  "resolved",
-  "all"
-]New value: +[
+  "attention",
+  "contact",
+  "no_reply",
+  "resolved",
+  "all"
+]

Changed4 schema fields changedOct 30, 2026

removedOutput schema / $defs / ConversationSummary

Removed value: -{
-  "description": "Conversation with contact info and message preview for list display.",
-  "properties": {
-    "can_reply": {
-      "default": true,
-      "title": "Can Reply",
-      "type": "boolean"
-    },
-    "channel_connection_id": {
-      "format": "uuid",
-      "title": "Channel Connection Id",
-      "type": "string"
-    },
-    "channel_type": {
-      "anyOf": [
-        {
-          "$ref": "#/$defs/ChannelType"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null
-    },
-    "contact": {
-      "anyOf": [
-        {
-          "$ref": "#/$defs/ConversationContactSummary"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null
-    },
-    "contact_id": {
-      "anyOf": [
-        {
-          "format": "uuid",
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null,
-      "title": "Contact Id"
-    },
-    "conversation_type": {
-      "$ref": "#/$defs/ConversationType",
-      "default": "direct"
-    },
-    "email_health": {
-      "anyOf": [
-        {
-          "enum": [
-            "healthy",
-            "recovering",
-            "delayed",
-            "incomplete",
-            "sender_unavailable",
-            "reconnect_required"
-          ],
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null,
-      "title": "Email Health"
-    },
-    "email_reply_target": {
-      "anyOf": [
-        {
-          "additionalProperties": true,
-          "type": "object"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null,
-      "title": "Email Reply Target"
-    },
-    "email_subject": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null,
-      "title": "Email Subject"
-    },
-    "group_id": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null,
-      "title": "Group Id"
-    },
-    "group_name": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null,
-      "title": "Group Name"
-    },
-    "group_picture_url": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null,
-      "title": "Group Picture Url"
-    },
-    "id": {
-      "format": "uuid",
-      "title": "Id",
-      "type": "string"
-    },
-    "inbox_views": {
-      "items": {
-        "enum": [
-          "attention",
-          "contact",
-          "resolved",
-          "all"
-        ],
-        "type": "string"
-      },
-      "title": "Inbox Views",
-      "type": "array"
-    },
-    "is_resolved": {
-      "default": false,
-      "title": "Is Resolved",
-      "type": "boolean"
-    },
-    "last_message_at": {
-      "anyOf": [
-        {
-          "format": "date-time",
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null,
-      "title": "Last Message At"
-    },
-    "last_message_direction": {
-      "anyOf": [
-        {
-          "$ref": "#/$defs/MessageDirection"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null
-    },
-    "last_message_preview": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null,
-      "title": "Last Message Preview"
-    },
-    "member_count": {
-      "default": 0,
-      "title": "Member Count",
-      "type": "integer"
-    },
-    "message_count": {
-      "default": 0,
-      "title": "Message Count",
-      "type": "integer"
-    },
-    "mode": {
-      "$ref": "#/$defs/ConversationMode",
-      "default": "auto_reply"
-    },
-    "pending_actions": {
-      "items": {
-        "discriminator": {
-          "mapping": {
-            "delivery_check": "#/$defs/DeliveryCheckAction",
-            "follow_up_blocked": "#/$defs/FollowUpBlockedAction",
-            "issue_review": "#/$defs/IssueReviewAction",
-            "release_check": "#/$defs/ReleaseCheckAction",
-            "reply_needed": "#/$defs/ReplyNeededAction",
-            "reply_review": "#/$defs/ReplyReviewAction"
-          },
-          "propertyName": "kind"
-        },
-        "oneOf": [
-          {
-            "$ref": "#/$defs/DeliveryCheckAction"
-          },
-          {
-            "$ref": "#/$defs/ReplyReviewAction"
-          },
-          {
-            "$ref": "#/$defs/ReplyNeededAction"
-          },
-          {
-            "$ref": "#/$defs/IssueReviewAction"
-          },
-          {
-            "$ref": "#/$defs/ReleaseCheckAction"
-          },
-          {
-            "$ref": "#/$defs/FollowUpBlockedAction"
-          }
-        ]
-      },
-      "title": "Pending Actions",
-      "type": "array"
-    },
-    "reply_owner": {
-      "default": "ai",
-      "enum": [
-        "human",
-        "ai_assisted",
-        "ai"
-      ],
-      "title": "Reply Owner",
-      "type": "string"
-    },
-    "resolved_at": {
-      "anyOf": [
-        {
-          "format": "date-time",
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null,
-      "title": "Resolved At"
-    },
-    "resolved_by": {
-      "anyOf": [
-        {
-          "format": "uuid",
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null,
-      "title": "Resolved By"
-    },
-    "started_at": {
-      "format": "date-time",
-      "title": "Started At",
-      "type": "string"
-    },
-    "status": {
-      "$ref": "#/$defs/ConversationStatus"
-    },
-    "waiting_on": {
-      "anyOf": [
-        {
-          "enum": [
-            "us",
-            "contact"
-          ],
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null,
-      "title": "Waiting On"
-    },
-    "waiting_since": {
-      "anyOf": [
-        {
-          "format": "date-time",
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null,
-      "title": "Waiting Since"
-    },
-    "workspace_id": {
-      "format": "uuid",
-      "title": "Workspace Id",
-      "type": "string"
-    }
-  },
-  "required": [
-    "id",
-    "workspace_id",
-    "channel_connection_id",
-    "status",
-    "started_at"
-  ],
-  "title": "ConversationSummary",
-  "type": "object"
-}

addedOutput schema / $defs / InboxConversation

Added value: +{
+  "description": "The Inbox row keyed by Agent; resolution fields describe only a current resolution.",
+  "properties": {
+    "agent_id": {
+      "format": "uuid",
+      "title": "Agent Id",
+      "type": "string"
+    },
+    "can_reply": {
+      "default": true,
+      "title": "Can Reply",
+      "type": "boolean"
+    },
+    "channel_connection_id": {
+      "format": "uuid",
+      "title": "Channel Connection Id",
+      "type": "string"
+    },
+    "channel_type": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/ChannelType"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null
+    },
+    "contact": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/ConversationContactSummary"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null
+    },
+    "contact_id": {
+      "anyOf": [
+        {
+          "format": "uuid",
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Contact Id"
+    },
+    "conversation_type": {
+      "$ref": "#/$defs/ConversationType",
+      "default": "direct"
+    },
+    "email_health": {
+      "anyOf": [
+        {
+          "enum": [
+            "healthy",
+            "recovering",
+            "delayed",
+            "incomplete",
+            "sender_unavailable",
+            "reconnect_required"
+          ],
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Email Health"
+    },
+    "email_reply_target": {
+      "anyOf": [
+        {
+          "additionalProperties": true,
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Email Reply Target"
+    },
+    "email_subject": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Email Subject"
+    },
+    "group_id": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Group Id"
+    },
+    "group_name": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Group Name"
+    },
+    "group_picture_url": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Group Picture Url"
+    },
+    "id": {
+      "format": "uuid",
+      "title": "Id",
+      "type": "string"
+    },
+    "inbox_views": {
+      "items": {
+        "enum": [
+          "attention",
+          "contact",
+          "resolved",
+          "all"
+        ],
+        "type": "string"
+      },
+      "title": "Inbox Views",
+      "type": "array"
+    },
+    "is_resolved": {
+      "default": false,
+      "title": "Is Resolved",
+      "type": "boolean"
+    },
+    "last_message_at": {
+      "anyOf": [
+        {
+          "format": "date-time",
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Last Message At"
+    },
+    "last_message_direction": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/MessageDirection"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null
+    },
+    "last_message_preview": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Last Message Preview"
+    },
+    "member_count": {
+      "default": 0,
+      "title": "Member Count",
+      "type": "integer"
+    },
+    "message_count": {
+      "default": 0,
+      "title": "Message Count",
+      "type": "integer"
+    },
+    "mode": {
+      "$ref": "#/$defs/ConversationMode",
+      "default": "auto_reply"
+    },
+    "pending_actions": {
+      "items": {
+        "discriminator": {
+          "mapping": {
+            "delivery_check": "#/$defs/DeliveryCheckAction",
+            "follow_up_blocked": "#/$defs/FollowUpBlockedAction",
+            "issue_review": "#/$defs/IssueReviewAction",
+            "release_check": "#/$defs/ReleaseCheckAction",
+            "reply_needed": "#/$defs/ReplyNeededAction",
+            "reply_review": "#/$defs/ReplyReviewAction"
+          },
+          "propertyName": "kind"
+        },
+        "oneOf": [
+          {
+            "$ref": "#/$defs/DeliveryCheckAction"
+          },
+          {
+            "$ref": "#/$defs/ReplyReviewAction"
+          },
+          {
+            "$ref": "#/$defs/ReplyNeededAction"
+          },
+          {
+            "$ref": "#/$defs/IssueReviewAction"
+          },
+          {
+            "$ref": "#/$defs/ReleaseCheckAction"
+          },
+          {
+            "$ref": "#/$defs/FollowUpBlockedAction"
+          }
+        ]
+      },
+      "title": "Pending Actions",
+      "type": "array"
+    },
+    "reply_owner": {
+      "default": "ai",
+      "enum": [
+        "human",
+        "ai_assisted",
+        "ai"
+      ],
+      "title": "Reply Owner",
+      "type": "string"
+    },
+    "resolved_at": {
+      "anyOf": [
+        {
+          "format": "date-time",
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Resolved At"
+    },
+    "resolved_by": {
+      "anyOf": [
+        {
+          "format": "uuid",
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Resolved By"
+    },
+    "started_at": {
+      "format": "date-time",
+      "title": "Started At",
+      "type": "string"
+    },
+    "status": {
+      "$ref": "#/$defs/ConversationStatus"
+    },
+    "waiting_on": {
+      "anyOf": [
+        {
+          "enum": [
+            "us",
+            "contact"
+          ],
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Waiting On"
+    },
+    "waiting_since": {
+      "anyOf": [
+        {
+          "format": "date-time",
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Waiting Since"
+    }
+  },
+  "required": [
+    "id",
+    "channel_connection_id",
+    "status",
+    "started_at",
+    "agent_id"
+  ],
+  "title": "InboxConversation",
+  "type": "object"
+}

changedOutput schema / properties / items / items / $ref

Previous value: -"#/$defs/ConversationSummary"New value: +"#/$defs/InboxConversation"

changedOutput schema / title

Previous value: -"DashboardConversationPage"New value: +"InboxPage"

Changed5 schema fields changedOct 28, 2026

addedOutput schema / $defs / ConversationSummary / properties / pending_actions / items / discriminator / mapping / follow_up_blocked
```
Added value: +"#/$defs/FollowUpBlockedAction"
```
addedOutput schema / $defs / ConversationSummary / properties / pending_actions / items / discriminator / mapping / release_check
```
Added value: +"#/$defs/ReleaseCheckAction"
```

changedOutput schema / $defs / ConversationSummary / properties / pending_actions / items / oneOf

Previous value: -[
-  {
-    "$ref": "#/$defs/DeliveryCheckAction"
-  },
-  {
-    "$ref": "#/$defs/ReplyReviewAction"
-  },
-  {
-    "$ref": "#/$defs/ReplyNeededAction"
-  },
-  {
-    "$ref": "#/$defs/IssueReviewAction"
-  }
-]New value: +[
+  {
+    "$ref": "#/$defs/DeliveryCheckAction"
+  },
+  {
+    "$ref": "#/$defs/ReplyReviewAction"
+  },
+  {
+    "$ref": "#/$defs/ReplyNeededAction"
+  },
+  {
+    "$ref": "#/$defs/IssueReviewAction"
+  },
+  {
+    "$ref": "#/$defs/ReleaseCheckAction"
+  },
+  {
+    "$ref": "#/$defs/FollowUpBlockedAction"
+  }
+]

addedOutput schema / $defs / FollowUpBlockedAction

Added value: +{
+  "properties": {
+    "kind": {
+      "const": "follow_up_blocked",
+      "title": "Kind",
+      "type": "string"
+    }
+  },
+  "required": [
+    "kind"
+  ],
+  "title": "FollowUpBlockedAction",
+  "type": "object"
+}

addedOutput schema / $defs / ReleaseCheckAction

Added value: +{
+  "properties": {
+    "kind": {
+      "const": "release_check",
+      "title": "Kind",
+      "type": "string"
+    }
+  },
+  "required": [
+    "kind"
+  ],
+  "title": "ReleaseCheckAction",
+  "type": "object"
+}

First observedOct 28, 2026

TDQS

A4.2/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the read-only and idempotent annotations, the description discloses that results are bounded and that cursors belong to the tenant and exact filter set. These details help prevent assumptions of exhaustive retrieval or cursor reuse across scopes, and nothing contradicts the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two compact sentences front-load the operation and cursor constraint, then provide the relevant sibling alternative. There is no filler or unnecessary repetition, although "bounded Workspace queue" is notably terse.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a read-only paginated list with six optional, fully described parameters and an output schema, the description supplies the important scope, cursor, and sibling-routing context. It could be more complete by defining the attention, contact, and no_reply views or queue ordering, since the view schema largely restates the enum names.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, with defaults, filters, limit, and cursor provenance already documented. The tenant and exact-filter wording reinforces cursor scope but adds little parameter meaning beyond the schema, so the high-coverage baseline applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

"Reads bounded Workspace queue" provides a specific operation, resource, and Workspace scope, while the title identifies the queue as Inbox conversations. The second sentence also distinguishes it from conversations_search, which handles text, outcome, and time searches.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives a useful routing cue: conversations_search is the sibling for finding an Agent's conversations by text, outcome, or time, rather than treating inbox_list as a general search tool. However, it does not explicitly state when to choose the Inbox queue over other inbox siblings, leaving that operational use case partly implied.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Replai tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?