veryfront__create_conversationproject_reference is required unless the token is project-scoped.
Access
No external-service connection is required. Use a Veryfront credential with access to the requested resources. Call type: Can change resources.Arguments
| Field | Type | Required | Description and constraints |
|---|---|---|---|
project_reference | string | No | Project identifier or slug that scopes the tool call. |
type | string | No | Provide the type. Values: "chat", "agent_task", "support", "channel", "project_agent". |
title | string | No | Short human-readable title for the record. Maximum length: 500. |
metadata | object | No | Additional structured metadata for the request. |
idempotency_key | string | No | Retrying with the same key and the same arguments returns the same conversation; different arguments fail with an idempotency conflict. Minimum length: 1. Maximum length: 255. |
initial_message | object | No | A first user message stored atomically with the conversation, as on REST POST /conversations. |
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__create_conversation",
"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 |
|---|---|---|---|
id | string | Yes | Conversation identifier. |
project_id | string or null | Yes | Project identifier that owns the conversation, or null for global/system conversations. |
responding_agent_id | string or null | Yes | Agent currently responding in the conversation, or null when no agent has responded. |
type | string | Yes | Conversation type, such as agent, support, or workflow conversation. |
title | string or null | Yes | Human-readable conversation title. |
summary | string or null | Yes | Short summary of the conversation state or topic. |
status | string | Yes | Lifecycle status of the conversation. |
current_node | string or null | Yes | Current workflow or agent node associated with the conversation, when available. |
message_count | number | Yes | Number of persisted messages in the conversation. |
last_message_at | string or null | Yes | Timestamp of the most recent message in the conversation. |
metadata | object or null | Yes | Additional machine-readable conversation metadata. |
created_by | string or null | Yes | User or actor identifier that created the conversation. |
archived_at | string or null | Yes | Timestamp when the conversation was archived, or null when active. |
created_at | string | Yes | Timestamp when the conversation was created. |
updated_at | string | Yes | Timestamp when the conversation was last updated. |
participants | object[] | Yes | Participants of the conversation. Empty on the confirmation body of delete_conversation. |
initial_message_id | string or null | No | The first message stored with the conversation, when initial_message was sent. |
Full schemas
{
"type": "object",
"properties": {
"project_reference": {
"type": "string",
"description": "Project identifier or slug that scopes the tool call."
},
"type": {
"type": "string",
"enum": [
"chat",
"agent_task",
"support",
"channel",
"project_agent"
],
"description": "Provide the type."
},
"title": {
"type": "string",
"maxLength": 500,
"description": "Short human-readable title for the record."
},
"metadata": {
"type": "object",
"additionalProperties": {
"description": "Additional structured values supplied to the tool."
},
"description": "Additional structured metadata for the request."
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Retrying with the same key and the same arguments returns the same conversation; different arguments fail with an idempotency conflict."
},
"initial_message": {
"type": "object",
"properties": {
"composing_user_id": {
"type": "string",
"format": "uuid",
"description": "Provide the composing user id."
},
"role": {
"type": "string",
"const": "user",
"description": "Always user; may be omitted."
},
"parts": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "text",
"description": "Provide the type."
},
"text": {
"type": "string",
"maxLength": 100000,
"description": "Provide the text."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false,
"description": "Structured option 1 details used by the tool."
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "image",
"description": "Provide the type."
},
"upload_id": {
"type": "string",
"format": "uuid",
"description": "Provide the upload id."
},
"media_type": {
"type": "string",
"description": "Provide the media type."
},
"url": {
"type": "string",
"description": "Provide the url."
}
},
"required": [
"type",
"upload_id",
"media_type"
],
"additionalProperties": false,
"description": "Structured option 2 details used by the tool."
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "file",
"description": "Provide the type."
},
"upload_id": {
"type": "string",
"format": "uuid",
"description": "Provide the upload id."
},
"media_type": {
"type": "string",
"description": "Provide the media type."
},
"filename": {
"type": "string",
"description": "Provide the filename."
},
"url": {
"type": "string",
"description": "Provide the url."
}
},
"required": [
"type",
"media_type"
],
"additionalProperties": false,
"description": "Structured option 3 details used by the tool."
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "tool_call",
"description": "Provide the type."
},
"id": {
"type": "string",
"description": "Unique identifier for the target record."
},
"name": {
"type": "string",
"description": "Human-readable name for the target record."
},
"input": {
"type": "object",
"additionalProperties": {
"description": "Additional structured values supplied to the tool."
},
"description": "Structured input details used by the tool."
},
"state": {
"type": "string",
"enum": [
"streaming",
"pending",
"completed",
"error"
],
"description": "Provide the state."
}
},
"required": [
"type",
"id",
"name",
"input",
"state"
],
"additionalProperties": false,
"description": "Structured option 4 details used by the tool."
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "tool_result",
"description": "Provide the type."
},
"tool_call_id": {
"type": "string",
"description": "Tool call identifier that links this request to a prior tool invocation."
},
"output": {
"description": "Provide the output."
},
"is_error": {
"type": "boolean",
"description": "Provide the is error."
}
},
"required": [
"type",
"tool_call_id"
],
"additionalProperties": false,
"description": "Structured option 5 details used by the tool."
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "reasoning",
"description": "Provide the type."
},
"text": {
"type": "string",
"maxLength": 100000,
"description": "Provide the text."
},
"signature": {
"type": "string",
"description": "Provide the signature."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false,
"description": "Structured option 6 details used by the tool."
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "citation",
"description": "Provide the type."
},
"source_id": {
"type": "string",
"description": "Provide the source id."
},
"url": {
"type": "string",
"description": "Provide the url."
},
"title": {
"type": "string",
"description": "Short human-readable title for the record."
},
"quote": {
"type": "string",
"description": "Provide the quote."
}
},
"required": [
"type",
"source_id"
],
"additionalProperties": false,
"description": "Structured option 7 details used by the tool."
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "source_document",
"description": "Provide the type."
},
"source_id": {
"type": "string",
"description": "Provide the source id."
},
"media_type": {
"type": "string",
"description": "Provide the media type."
},
"title": {
"type": "string",
"description": "Short human-readable title for the record."
},
"filename": {
"type": "string",
"description": "Provide the filename."
}
},
"required": [
"type",
"source_id",
"media_type",
"title"
],
"additionalProperties": false,
"description": "Structured option 8 details used by the tool."
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "step_start",
"description": "Provide the type."
}
},
"required": [
"type"
],
"additionalProperties": false,
"description": "Structured option 9 details used by the tool."
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "error",
"description": "Provide the type."
},
"code": {
"type": "string",
"description": "Provide the code."
},
"message": {
"type": "string",
"description": "Provide the message."
}
},
"required": [
"type",
"code",
"message"
],
"additionalProperties": false,
"description": "Structured option 10 details used by the tool."
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "data",
"description": "Provide the type."
},
"name": {
"type": "string",
"description": "Human-readable name for the target record."
},
"value": {
"description": "Provide the value."
}
},
"required": [
"type",
"name"
],
"additionalProperties": false,
"description": "Structured option 11 details used by the tool."
}
],
"description": "One part item supplied to the tool."
},
"minItems": 1,
"maxItems": 200,
"description": "Provide one or more part values."
},
"idempotency_key": {
"type": "string",
"maxLength": 255,
"description": "Provide the idempotency key."
},
"metadata": {
"type": "object",
"additionalProperties": {
"description": "Additional structured values supplied to the tool."
},
"description": "Additional structured metadata for the request."
}
},
"required": [
"parts"
],
"additionalProperties": false,
"description": "A first user message stored atomically with the conversation, as on REST POST /conversations."
}
},
"additionalProperties": false,
"description": "Arguments for the create_conversation tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
{
"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."
},
"type": {
"type": "string",
"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",
"description": "Lifecycle status of the conversation."
},
"current_node": {
"type": [
"string",
"null"
],
"description": "Current workflow or agent node associated with the conversation, when available."
},
"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 for the record."
},
{
"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": "Conversation participant identifier."
},
"participant_id": {
"type": [
"string",
"null"
],
"description": "Canonical participant identity identifier shared by user and agent participants."
},
"participant_type": {
"type": "string",
"description": "Semantic participant type, such as user or agent."
},
"user_id": {
"type": [
"string",
"null"
],
"description": "User identifier for the participant, or null for non-user actors."
},
"agent_id": {
"type": [
"string",
"null"
],
"description": "Agent identifier for agent participants, or null for user participants."
},
"display_name": {
"type": [
"string",
"null"
],
"description": "Human-readable participant name when available."
},
"avatar_url": {
"type": [
"string",
"null"
],
"description": "Participant avatar URL when available."
},
"role": {
"type": "string",
"description": "Participant role within the conversation."
}
},
"required": [
"id",
"participant_id",
"participant_type",
"user_id",
"agent_id",
"display_name",
"avatar_url",
"role"
],
"additionalProperties": false,
"description": "Participant summary embedded in a conversation record."
},
"description": "Participants of the conversation. Empty on the confirmation body of delete_conversation."
},
"initial_message_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null",
"description": "The initial message id returned by the tool."
}
],
"description": "The first message stored with the conversation, when initial_message was sent."
}
},
"required": [
"id",
"project_id",
"responding_agent_id",
"type",
"title",
"summary",
"status",
"current_node",
"message_count",
"last_message_at",
"metadata",
"created_by",
"archived_at",
"created_at",
"updated_at",
"participants"
],
"additionalProperties": false,
"description": "Conversation record returned by MCP conversation tools.",
"$schema": "http://json-schema.org/draft-07/schema#"
}