veryfront__list_conversationsAccess
No external-service connection is required. Use a Veryfront credential with access to the requested resources. Call type: Read-only.Arguments
| Field | Type | Required | Description and constraints |
|---|---|---|---|
project_reference | string | No | Lists conversations for the current user, optionally filtered by project, type, participants, agent, user or title, and sorted like REST GET /conversations. Minimum length: 1. |
type | string | No | Only conversations of this type, e.g. chat. |
participant_ids | string[] | No | Only conversations that include every listed participant id (at most 20 UUIDs). |
agent_id | string | No | Only conversations with this agent participant (public agent id). Minimum length: 1. Maximum length: 128. |
user_id | string | No | Only conversations with this user participant (user UUID). Format: uuid. |
search | string | No | Case-insensitive title substring. Minimum length: 1. Maximum length: 200. |
cursor | string | No | Opaque pagination cursor returned by a previous response. |
limit | integer | No | Maximum number of results to return. Minimum: 1. Maximum: 100. |
sort_by | string | No | Sort key. Defaults to updated_at. Default: "updated_at". Values: "updated_at", "created_at", "title", "message_count". |
sort_order | string | No | Sort direction. Defaults to desc. Default: "desc". Values: "asc", "desc". |
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.request.json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "veryfront__list_conversations",
"arguments": {}
}
}
Result
The published output shape is summarized below. Inspect both the MCP response content andisError when handling a call.
| Field | Type | Required | Description and constraints |
|---|---|---|---|
data | object[] | Yes | Conversation records for the requested page. |
page_info | object | Yes | Pagination cursors for the conversation list. |
Full schemas
{
"type": "object",
"properties": {
"project_reference": {
"type": "string",
"minLength": 1,
"description": "Lists conversations for the current user, optionally filtered by project, type, participants, agent, user or title, and sorted like REST GET /conversations."
},
"type": {
"type": "string",
"description": "Only conversations of this type, e.g. chat."
},
"participant_ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"description": "One participant id item supplied to the tool."
},
"description": "Only conversations that include every listed participant id (at most 20 UUIDs)."
},
"agent_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"description": "Only conversations with this agent participant (public agent id)."
},
"user_id": {
"type": "string",
"format": "uuid",
"description": "Only conversations with this user participant (user UUID)."
},
"search": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Case-insensitive title substring."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor returned by a previous response."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Maximum number of results to return."
},
"sort_by": {
"type": "string",
"enum": [
"updated_at",
"created_at",
"title",
"message_count"
],
"description": "Sort key. Defaults to updated_at.",
"default": "updated_at"
},
"sort_order": {
"type": "string",
"enum": [
"asc",
"desc"
],
"description": "Sort direction. Defaults to desc.",
"default": "desc"
}
},
"additionalProperties": false,
"description": "Arguments for the list_conversations tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Conversation identifier."
},
"project_id": {
"type": [
"string",
"null"
],
"description": "Project identifier that owns the conversation, or null for global/system conversations."
},
"responding_agent_id": {
"type": [
"string",
"null"
],
"description": "Agent currently responding in the conversation, or null when no agent has responded.",
"default": null
},
"type": {
"type": "string",
"enum": [
"chat",
"default_chat",
"plan",
"research",
"agent_task",
"support",
"channel",
"project_agent"
],
"description": "Conversation type, such as agent, support, or workflow conversation."
},
"title": {
"type": [
"string",
"null"
],
"description": "Human-readable conversation title."
},
"summary": {
"type": [
"string",
"null"
],
"description": "Short summary of the conversation state or topic."
},
"status": {
"type": "string",
"enum": [
"active",
"archived",
"deleted"
],
"description": "Lifecycle status of the conversation."
},
"current_node": {
"type": [
"string",
"null"
],
"description": "Selected conversation message node for the active branch, or null when no message is selected."
},
"message_count": {
"type": "number",
"description": "Number of persisted messages in the conversation."
},
"last_message_at": {
"type": [
"string",
"null"
],
"description": "Timestamp of the most recent message in the conversation."
},
"metadata": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"description": "Additional structured values associated with this result."
},
"description": "Additional structured metadata returned by the tool."
},
{
"type": "null",
"description": "Additional structured metadata returned by the tool."
}
],
"description": "Additional machine-readable conversation metadata."
},
"created_by": {
"type": [
"string",
"null"
],
"description": "User or actor identifier that created the conversation."
},
"archived_at": {
"type": [
"string",
"null"
],
"description": "Timestamp when the conversation was archived, or null when active."
},
"created_at": {
"type": "string",
"description": "Timestamp when the conversation was created."
},
"updated_at": {
"type": "string",
"description": "Timestamp when the conversation was last updated."
},
"participants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the returned record."
},
"participant_id": {
"type": [
"string",
"null"
]
},
"participant_type": {
"type": "string",
"enum": [
"user",
"agent"
],
"default": "user"
},
"user_id": {
"type": [
"string",
"null"
]
},
"agent_id": {
"type": [
"string",
"null"
]
},
"display_name": {
"type": [
"string",
"null"
]
},
"agent_kind": {
"anyOf": [
{
"type": "string",
"const": "project"
},
{
"type": "null",
"description": "The agent kind returned by the tool."
}
]
},
"avatar_url": {
"type": [
"string",
"null"
]
},
"role": {
"type": "string",
"enum": [
"owner",
"member",
"viewer"
]
}
},
"required": [
"id",
"role"
],
"additionalProperties": false
},
"description": "Participants of the conversation. Empty on the confirmation body of delete_conversation.",
"default": []
}
},
"required": [
"id",
"type",
"status",
"message_count",
"created_by",
"created_at",
"updated_at"
],
"additionalProperties": false,
"description": "Conversation record returned by MCP conversation tools."
},
"description": "Conversation records for the requested page."
},
"page_info": {
"type": "object",
"properties": {
"self": {
"type": [
"string",
"null"
],
"description": "Cursor representing the current page."
},
"first": {
"type": "null",
"description": "Always null because these MCP pagination flows do not expose a first-page cursor."
},
"next": {
"type": [
"string",
"null"
],
"description": "Cursor for the next page, or null when there are no more results."
},
"prev": {
"type": [
"string",
"null"
],
"description": "Cursor for the previous page, or null when unavailable."
}
},
"required": [
"self",
"first",
"next",
"prev"
],
"additionalProperties": false,
"description": "Pagination cursors for the conversation list."
}
},
"required": [
"data",
"page_info"
],
"additionalProperties": false,
"description": "Paginated conversation list response.",
"$schema": "http://json-schema.org/draft-07/schema#"
}