SetLuca

Official

by setluca

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

Get a conversation

luca_conversations_get

Read-onlyIdempotent

Retrieve a conversation's messages and lead context to review prospect history, optionally overriding the configured workspace by ID or slug.

Instructions

Get a conversation with messages and lead context.

Luca operation: GET /api/conversations/{id} Required scopes: conversations:read Required OAuth scope: luca:read; data sensitivity: full_content Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "id": "<id>"
    },
    "name": "luca_conversations_get"
  }
}

Input Schema

Name	Required	Description
`id`	Yes
`workspaceId`	No	Optional Luca workspace id override.
`workspaceSlug`	No	Optional Luca workspace slug override.

Output Schema

Name	Required	Description	Default
`result`	Yes
`provenance`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed7 schema fields changedv0.4.2Nov 11, 2026

addedOutput schema / properties / result / properties / conversation / properties / draftingState
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / properties / result / properties / conversation / properties / leadPaused
```
Added value: +{
+  "type": "boolean"
+}
```

addedOutput schema / properties / result / properties / conversation / properties / leadPausedUntil

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / result / properties / conversation / properties / readThroughMessageId

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / result / properties / followUpSkip

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": true,
+      "properties": {
+        "at": {
+          "type": "string"
+        },
+        "reason": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / result / properties / isDemo
```
Added value: +{
+  "type": "boolean"
+}
```

addedOutput schema / properties / result / properties / metaWindow

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": true,
+      "properties": {
+        "kind": {
+          "type": "string"
+        },
+        "openedAt": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    {
+      "additionalProperties": true,
+      "properties": {
+        "kind": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    {
+      "additionalProperties": true,
+      "properties": {
+        "kind": {
+          "type": "string"
+        },
+        "reason": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    }
+  ]
+}

Changed6 schema fields changedv0.4.1Oct 28, 2026

addedOutput schema / properties / result / properties / conversation / properties / qualificationProgress / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "number"
+  },
+  {
+    "type": "boolean"
+  },
+  {
+    "type": "object"
+  },
+  {
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / result / properties / conversation / properties / unread
```
Added value: +{
+  "type": "boolean"
+}
```

addedOutput schema / properties / result / properties / lead / properties / customFields / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "number"
+  },
+  {
+    "type": "boolean"
+  },
+  {
+    "type": "object"
+  },
+  {
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / result / properties / pendingReview / anyOf

Previous value: -[
-  {
-    "additionalProperties": true,
-    "properties": {
-      "coachId": {
-        "type": "string"
-      },
-      "confidence": {
-        "type": "number"
-      },
-      "conversationId": {
-        "type": "string"
-      },
-      "createdAt": {
-        "type": "string"
-      },
-      "criticIssues": {},
-      "draftBody": {
-        "type": "string"
-      },
-      "id": {
-        "type": "string"
-      },
-      "originThreadId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "qualification": {},
-      "resolvedAt": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "sourceMessageId": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "status": {
-        "type": "string"
-      },
-      "voiceMatchScore": {
-        "type": "number"
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": true,
+    "properties": {
+      "coachId": {
+        "type": "string"
+      },
+      "confidence": {
+        "type": "number"
+      },
+      "conversationId": {
+        "type": "string"
+      },
+      "createdAt": {
+        "type": "string"
+      },
+      "criticIssues": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "number"
+          },
+          {
+            "type": "boolean"
+          },
+          {
+            "type": "object"
+          },
+          {
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "draftBody": {
+        "type": "string"
+      },
+      "id": {
+        "type": "string"
+      },
+      "originThreadId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "qualification": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "number"
+          },
+          {
+            "type": "boolean"
+          },
+          {
+            "type": "object"
+          },
+          {
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "resolvedAt": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "sourceMessageId": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "status": {
+        "type": "string"
+      },
+      "voiceMatchScore": {
+        "type": "number"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / result / properties / replyFailures
```
Added value: +{
+  "type": "array"
+}
```

changedOutput schema / properties / result / x-luca-redacted-fields

Previous value: -[
-  "conversation.qualificationProgress",
-  "copilotContext.leadDisplayName",
-  "lead.customFields",
-  "lead.displayName",
-  "lead.externalUserId",
-  "lead.profilePhotoUrl",
-  "messages[].body",
-  "messages[].media",
-  "messages[].mediaUrls",
-  "messages[].rawPayload",
-  "pendingReview.criticIssues",
-  "pendingReview.draftBody",
-  "pendingReview.qualification"
-]New value: +[
+  "conversation.qualificationProgress",
+  "copilotContext.leadDisplayName",
+  "lead.customFields",
+  "lead.displayName",
+  "lead.externalUserId",
+  "lead.profilePhotoUrl",
+  "messages[].body",
+  "messages[].media",
+  "messages[].mediaUrls",
+  "messages[].rawPayload",
+  "pendingReview.criticIssues",
+  "pendingReview.draftBody",
+  "pendingReview.qualification",
+  "replyFailures[].body",
+  "replyFailures[].content"
+]

First observedv0.4.0Oct 21, 2026

TDQS

A3.7/5.0

Behavior4/5

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

Annotations already cover read-only, idempotent, non-destructive and closed-world hints, yet the description adds genuinely new context: the backing endpoint, required OAuth scopes ('conversations:read', 'luca:read') and a data sensitivity label of full_content, which signals PII-laden output. The 'Does not require idempotency' line merely restates the annotation.

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

Conciseness4/5

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

The core purpose is front-loaded in the first sentence and the metadata lines are compact and scannable. The idempotency sentence is redundant with idempotentHint=true and could be dropped without loss.

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

Completeness5/5

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

An output schema exists, so return-value documentation is not required. For a simple read-by-id tool the description already supplies endpoint, auth scopes, sensitivity classification and workspace-override semantics, leaving nothing material an agent needs in order to call it correctly.

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

Parameters4/5

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

Schema coverage is 67%, with workspaceId and workspaceSlug already documented inline. The description adds real meaning by explaining that those overrides exist relative to a default workspace configured by the environment, which the schema does not convey; only the UUID format of id is left purely to the schema.

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

Purpose4/5

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

States a specific verb and resource ('Get a conversation') and adds that the payload includes messages and lead context, which distinguishes it from the sibling list/messages tools. It does not explicitly name a sibling to route away from, but the scope of what is returned is clear.

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

Usage Guidelines2/5

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

There is no statement of when to reach for this tool versus luca_conversations_list or luca_conversations_messages, nor any prerequisite guidance beyond scope requirements. The only conditional sentence concerns workspace override, which is parameter behavior, not usage selection.

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

Deploy Server