Get conversation message - Veryfront

veryfront__get_conversation_message

Access

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
`conversation_id`	`string`	Yes	Conversation identifier that scopes the request. Format: `uuid`.
`message_id`	`string`	Yes	Provide the message id. Format: `uuid`.

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__get_conversation_message",
    "arguments": {
      "conversation_id": "00000000-0000-4000-8000-000000000000",
      "message_id": "00000000-0000-4000-8000-000000000000"
    }
  }
}

Result

The published output shape is summarized below. Inspect both the MCP response content and isError when handling a call.

Field	Type	Required	Description and constraints
`id`	`string`	Yes	Message identifier.
`conversation_id`	`string`	Yes	Conversation identifier that owns the message.
`parent_id`	`string or null`	Yes	Parent message identifier when the message belongs to a branch or reply chain.
`seq`	`number`	Yes	Monotonic sequence number within the conversation.
`role`	`string`	Yes	Message role such as user, assistant, tool, or system.
`created_by`	`string or null`	Yes	User or actor identifier that created the message.
`sender_type`	`string`	Yes	Sender kind: user, webhook, `service_account`, integration, agent or system.
`sender_id`	`string or null`	Yes	Sender identifier: the participant or agent for an agent message, otherwise the author.
`sender_display_name`	`string or null`	Yes	Human-readable sender name when available.
`parts`	`value[]`	Yes	Structured message parts, including text, tool invocations, or rich content blocks.
`model`	`string or null`	Yes	Model identifier that generated the message, when applicable.
`run_usage`	`object or null`	No	Token usage and cost of the whole run that produced an assistant message; absent when none is recorded.
`token_usage`	`value or null`	No	Token accounting metadata associated with the message.
`finish_reason`	`string or null`	Yes	Completion finish reason for model-generated messages.
`cost_credits`	`string or null`	Yes	Credit cost attributed to the message, when tracked.
`status`	`string`	Yes	Lifecycle status of the message.
`edited_at`	`string or null`	Yes	Timestamp when the message was edited, or null when unedited.
`idempotency_key`	`string or null`	Yes	Idempotency key used to deduplicate message creation requests.
`metadata`	`object or null`	Yes	Additional machine-readable message metadata.
`created_at`	`string`	Yes	Timestamp when the message was created.
`updated_at`	`string or null`	Yes	Timestamp when the message was last updated.

Full schemas

{
  "type": "object",
  "properties": {
    "conversation_id": {
      "type": "string",
      "format": "uuid",
      "description": "Conversation identifier that scopes the request."
    },
    "message_id": {
      "type": "string",
      "format": "uuid",
      "description": "Provide the message id."
    }
  },
  "required": [
    "conversation_id",
    "message_id"
  ],
  "additionalProperties": false,
  "description": "Arguments for the get_conversation_message tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Message identifier."
    },
    "conversation_id": {
      "type": "string",
      "description": "Conversation identifier that owns the message."
    },
    "parent_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "Parent message identifier when the message belongs to a branch or reply chain."
    },
    "seq": {
      "type": "number",
      "description": "Monotonic sequence number within the conversation."
    },
    "role": {
      "type": "string",
      "description": "Message role such as user, assistant, tool, or system."
    },
    "created_by": {
      "type": [
        "string",
        "null"
      ],
      "description": "User or actor identifier that created the message."
    },
    "sender_type": {
      "type": "string",
      "description": "Sender kind: user, webhook, service_account, integration, agent or system."
    },
    "sender_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "Sender identifier: the participant or agent for an agent message, otherwise the author."
    },
    "sender_display_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Human-readable sender name when available."
    },
    "parts": {
      "type": "array",
      "items": {
        "description": "One part item associated with this record."
      },
      "description": "Structured message parts, including text, tool invocations, or rich content blocks."
    },
    "model": {
      "type": [
        "string",
        "null"
      ],
      "description": "Model identifier that generated the message, when applicable."
    },
    "run_usage": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "scope": {
              "type": "string",
              "const": "run",
              "description": "The scope associated with this record."
            },
            "model": {
              "type": [
                "string",
                "null"
              ],
              "description": "AI model id or alias. Call list_models for the ids this deployment serves; never invent a version suffix."
            },
            "input_tokens": {
              "type": "integer",
              "minimum": 0,
              "description": "The input tokens associated with this record."
            },
            "output_tokens": {
              "type": "integer",
              "minimum": 0,
              "description": "The output tokens associated with this record."
            },
            "cache_creation_input_tokens": {
              "type": "integer",
              "minimum": 0,
              "description": "The cache creation input tokens associated with this record."
            },
            "cache_read_input_tokens": {
              "type": "integer",
              "minimum": 0,
              "description": "The cache read input tokens associated with this record."
            },
            "reasoning_tokens": {
              "type": "integer",
              "minimum": 0,
              "description": "The reasoning tokens associated with this record."
            },
            "total_tokens": {
              "type": "integer",
              "minimum": 0,
              "description": "The total tokens associated with this record."
            },
            "model_calls": {
              "type": "integer",
              "minimum": 0,
              "description": "The model calls associated with this record."
            },
            "cost_credits": {
              "type": [
                "string",
                "null"
              ],
              "description": "The cost credits associated with this record."
            }
          },
          "required": [
            "scope",
            "model",
            "input_tokens",
            "output_tokens",
            "cache_creation_input_tokens",
            "cache_read_input_tokens",
            "reasoning_tokens",
            "total_tokens",
            "model_calls",
            "cost_credits"
          ],
          "additionalProperties": false,
          "description": "Structured run usage details associated with this record."
        },
        {
          "type": "null",
          "description": "The run usage returned by the tool."
        }
      ],
      "description": "Token usage and cost of the whole run that produced an assistant message; absent when none is recorded."
    },
    "token_usage": {
      "anyOf": [
        {
          "description": "The token usage associated with this record."
        },
        {
          "type": "null",
          "description": "The token usage returned by the tool."
        }
      ],
      "description": "Token accounting metadata associated with the message."
    },
    "finish_reason": {
      "type": [
        "string",
        "null"
      ],
      "description": "Completion finish reason for model-generated messages."
    },
    "cost_credits": {
      "type": [
        "string",
        "null"
      ],
      "description": "Credit cost attributed to the message, when tracked."
    },
    "status": {
      "type": "string",
      "description": "Lifecycle status of the message."
    },
    "edited_at": {
      "type": [
        "string",
        "null"
      ],
      "description": "Timestamp when the message was edited, or null when unedited."
    },
    "idempotency_key": {
      "type": [
        "string",
        "null"
      ],
      "description": "Idempotency key used to deduplicate message creation requests."
    },
    "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 message metadata."
    },
    "created_at": {
      "type": "string",
      "description": "Timestamp when the message was created."
    },
    "updated_at": {
      "type": [
        "string",
        "null"
      ],
      "description": "Timestamp when the message was last updated."
    }
  },
  "required": [
    "id",
    "conversation_id",
    "parent_id",
    "seq",
    "role",
    "created_by",
    "sender_type",
    "sender_id",
    "sender_display_name",
    "parts",
    "model",
    "finish_reason",
    "cost_credits",
    "status",
    "edited_at",
    "idempotency_key",
    "metadata",
    "created_at",
    "updated_at"
  ],
  "additionalProperties": false,
  "description": "Conversation message record returned by MCP conversation tools.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}