Well

Show the company candidates

well_show_company_candidates

Show the user the detected COMPANY candidates on a card and let them pick which company is theirs: a tile per detected company candidate with its confidence, and a company-registry search at the top for the case where none was detected.

⚠️ ONLY when the user must choose or find the company to create a workspace from: the zero-company case (a membership workspace with no own company attached), or the user says the company set on this workspace is wrong, in which case a new workspace is minted from their pick and this one stays as it is. For the values alone, read well_get_own_company, which draws nothing.

⚠️ WAIT ON THE CARD IN THE TURN THAT DREW IT. Write your one line for the user FIRST — the wait holds the turn open for up to a minute, and a user looking at a card with no sentence beside it has been given no reason to click — then call well_wait_for_selection({ kind: "company_pick" }), which this result's next_step also states. The card's own footer mints the company workspace and switches into it on the click, so never mint it yourself after the pick.

⚠️ NEVER PICK THE COMPANY for the user, and never infer it from the workspace name.

Input Schema

Name	Required	Description
`title`	No	Heading for the card, written from what the user asked for (e.g. "Create a workspace for your company" for "Create a workspace for my company"). The card is drawn only for a request that names no company, so the heading names none. At most 120 characters. Omit to keep the default heading; an empty string is rejected rather than rendered as a blank heading.
`subtitle`	No	Supporting line under the card's heading. At most 240 characters. Omit to keep the default wording; an empty string is rejected rather than rendered blank.
`workspace_id`	No	Target workspace. Omit when the token authorizes one workspace. Required when it authorizes several — a write lands in exactly one workspace and this call would not say which.
`conversation_id`	No	The conversation id returned by the previous Well result, in its meta under well/conversation_id, in its structuredContent, or in its JSON text block. Pass it back on every call in the same conversation, including a call a card makes, so the chosen workspace and the earlier answers still apply. It decides the conversation on its own: nothing the host states about the session replaces it. Omit it only on the first call of a conversation.
`idempotency_key`	No	Optional client-supplied key. A retried write with the same key returns the original result instead of re-applying the operation.
`workspace_scope`	No	Restrict this call to the family: the token's primary workspace plus the company workspaces under it that you are a member of. Unrelated authorized workspaces drop out of the read; row reads merge across the family, while a per-workspace figure still reports exactly one workspace.

Output Schema

Name	Required	Description
`error`	No
`anchor`	Yes
`success`	Yes
`next_step`	No	What to do with the card this result renders. Added by the dispatcher when the card asks for a click.
`candidates`	Yes
`own_identity`	Yes	The own-identity module's decision for this workspace, or null when the workspace row could not be read. A decision is a detection output, never a confirmed anchor — only anchor is confirmed.
`own_companies`	Yes	The companies the workspace counts as itself, anchor first, then holders, then self-candidates. Filter mine-versus-theirs by the company_id of every anchor and holder row, never by anchor alone. Empty when the workspace has none.
`conversation_id`	No	The conversation this result belongs to. Pass it back as the conversation_id argument on every later Well call in the same conversation.
`newly_connected`	No	Tools that connected to this workspace since the last result and that no session was told about yet, oldest first. Present only when at least one tool is new. The connected-line rule says when to tell an entry; when it does, one line per entry, in the person's language: "<name> is connected.". Never fold several entries into one sentence. Each entry comes back once, on one result only: never repeat its line later.
`resolved_workspace`	No	The workspace that answered, when the caller named none and the token authorizes several.
`conversation_id_note`	No	Present only when the server opened a fresh lane, stating that no choice recorded earlier was read.
`conversation_id_source`	No	Where the conversation id came from: the host's own request meta, the caller's argument, or a fresh lane the server opened.
`own_companies_complete`	Yes	True when own_companies is the whole own set. False when it was cut at a bound: a company missing from it may still be the workspace's own, so never classify a company as theirs from this list.

Schema Changelog

Changes observed during successful MCP inspections.

Changed24 schema fields changedOct 28, 2026

changedOutput schema / properties / anchor / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "company_id": {
-        "type": "string"
-      },
-      "registered_name": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "registry_country": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "The own company's registry country as an ISO 3166-1 alpha-2 code, null when unknown."
-      },
-      "trade_name": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "required": [
-      "company_id",
-      "registered_name",
-      "trade_name",
-      "registry_country"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "company_id": {
+        "type": "string"
+      },
+      "registered_name": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "registry_country": {
+        "description": "The own company's registry country as an ISO 3166-1 alpha-2 code, null when unknown.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "trade_name": {
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "company_id",
+      "registered_name",
+      "trade_name",
+      "registry_country"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / candidates / items / properties / business_type / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / candidates / items / properties / business_type / type
```
Added value: +[
+  "string",
+  "null"
+]
```
removedOutput schema / properties / candidates / items / properties / company_id / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / candidates / items / properties / company_id / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / candidates / items / properties / country / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / candidates / items / properties / country / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / candidates / items / properties / domain / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / candidates / items / properties / domain / type
```
Added value: +[
+  "string",
+  "null"
+]
```
removedOutput schema / properties / candidates / items / properties / existing_workspace_id / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / candidates / items / properties / existing_workspace_id / type
```
Added value: +[
+  "string",
+  "null"
+]
```
removedOutput schema / properties / candidates / items / properties / registered_name / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / candidates / items / properties / registered_name / type
```
Added value: +[
+  "string",
+  "null"
+]
```
removedOutput schema / properties / candidates / items / properties / remote_logo_url / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / candidates / items / properties / remote_logo_url / type
```
Added value: +[
+  "string",
+  "null"
+]
```
removedOutput schema / properties / candidates / items / properties / trade_name / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / candidates / items / properties / trade_name / type
```
Added value: +[
+  "string",
+  "null"
+]
```
removedOutput schema / properties / own_companies / items / properties / registered_name / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / own_companies / items / properties / registered_name / type
```
Added value: +[
+  "string",
+  "null"
+]
```
removedOutput schema / properties / own_companies / items / properties / trade_name / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / own_companies / items / properties / trade_name / type
```
Added value: +[
+  "string",
+  "null"
+]
```

changedOutput schema / properties / own_identity / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "ask_kind": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "When decision is ask, what is being asked: companies_or_clients (pick the real own company among several), conflicting_anchor_identity (evidence disagrees with the anchor), pending_identifier (a named company lacks a legal identifier), confirm_entity (one named company is proposed; confirm it is the user's own)."
-      },
-      "company_id": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "The company the verdict proposes or anchors on, when one was named."
-      },
-      "company_ids": {
-        "description": "Public ids of every company subject the verdict surfaced — the proposal and ask subjects.",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "decision": {
-        "anyOf": [
-          {
-            "enum": [
-              "propose",
-              "ask",
-              "none"
-            ],
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "The own-identity detector's last completed verdict for this workspace — propose (a company worth proposing), ask (ambiguity a person must resolve), or none. Null when no detection pass has settled yet."
-      },
-      "holder_candidates": {
-        "description": "Registry entries a lookup found for bank holders the detector judged to be organisations, normally none or one. A lead for the user's registry pick, not a confirmed identity and not a proposal: it names no workspace company, decision can stay none beside it, and its identifier is withheld.",
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "country": {
-              "type": "string"
-            },
-            "name": {
-              "type": "string"
-            },
-            "scheme": {
-              "description": "The kind of identifier the entry is known by, never its value.",
-              "type": "string"
-            }
-          },
-          "required": [
-            "scheme",
-            "name",
-            "country"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "pending": {
-        "description": "True while an identity-resolution pass is queued or in flight — a fresher decision may follow; re-read after it settles.",
-        "type": "boolean"
-      },
-      "reason": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "The audit reason the verdict carries, in the resolver-reason vocabulary."
-      },
-      "registry_candidates": {
-        "description": "For an ask whose companies lack a legal identifier: the one registry entry a lookup found for a company, when exactly one matched. A lead for the user's registry pick, not a confirmed identity; its identifier is withheld.",
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "company_id": {
-              "description": "The company a registry entry was found for.",
-              "type": "string"
-            },
-            "country": {
-              "type": "string"
-            },
-            "name": {
-              "type": "string"
-            },
-            "scheme": {
-              "description": "The kind of identifier the entry is known by, never its value.",
-              "type": "string"
-            }
-          },
-          "required": [
-            "company_id",
-            "scheme",
-            "name",
-            "country"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "suggestions": {
-        "description": "Ranked suggestions the detector folded — leads, not proposal cards; a person's pick is what admits one.",
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "company_id": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "rank": {
-              "type": "number"
-            },
-            "strength": {
-              "type": "number"
-            }
-          },
-          "required": [
-            "company_id",
-            "rank",
-            "strength"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "decision",
-      "reason",
-      "company_id",
-      "ask_kind",
-      "company_ids",
-      "suggestions",
-      "registry_candidates",
-      "holder_candidates",
-      "pending"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "ask_kind": {
+        "description": "When decision is ask, what is being asked: companies_or_clients (pick the real own company among several), conflicting_anchor_identity (evidence disagrees with the anchor), pending_identifier (a named company lacks a legal identifier), confirm_entity (one named company is proposed; confirm it is the user's own).",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "company_id": {
+        "description": "The company the verdict proposes or anchors on, when one was named.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "company_ids": {
+        "description": "Public ids of every company subject the verdict surfaced — the proposal and ask subjects.",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "decision": {
+        "anyOf": [
+          {
+            "enum": [
+              "propose",
+              "ask",
+              "none"
+            ],
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "The own-identity detector's last completed verdict for this workspace — propose (a company worth proposing), ask (ambiguity a person must resolve), or none. Null when no detection pass has settled yet."
+      },
+      "holder_candidates": {
+        "description": "Registry entries a lookup found for bank holders the detector judged to be organisations, normally none or one. A lead for the user's registry pick, not a confirmed identity and not a proposal: it names no workspace company, decision can stay none beside it, and its identifier is withheld.",
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "country": {
+              "type": "string"
+            },
+            "name": {
+              "type": "string"
+            },
+            "scheme": {
+              "description": "The kind of identifier the entry is known by, never its value.",
+              "type": "string"
+            }
+          },
+          "required": [
+            "scheme",
+            "name",
+            "country"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "pending": {
+        "description": "True while an identity-resolution pass is queued or in flight — a fresher decision may follow; re-read after it settles.",
+        "type": "boolean"
+      },
+      "reason": {
+        "description": "The audit reason the verdict carries, in the resolver-reason vocabulary.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "registry_candidates": {
+        "description": "For an ask whose companies lack a legal identifier: the one registry entry a lookup found for a company, when exactly one matched. A lead for the user's registry pick, not a confirmed identity; its identifier is withheld.",
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "company_id": {
+              "description": "The company a registry entry was found for.",
+              "type": "string"
+            },
+            "country": {
+              "type": "string"
+            },
+            "name": {
+              "type": "string"
+            },
+            "scheme": {
+              "description": "The kind of identifier the entry is known by, never its value.",
+              "type": "string"
+            }
+          },
+          "required": [
+            "company_id",
+            "scheme",
+            "name",
+            "country"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "suggestions": {
+        "description": "Ranked suggestions the detector folded — leads, not proposal cards; a person's pick is what admits one.",
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "company_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "rank": {
+              "type": "number"
+            },
+            "strength": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "company_id",
+            "rank",
+            "strength"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "decision",
+      "reason",
+      "company_id",
+      "ask_kind",
+      "company_ids",
+      "suggestions",
+      "registry_candidates",
+      "holder_candidates",
+      "pending"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / resolved_workspace / properties / name / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / resolved_workspace / properties / name / type
```
Added value: +[
+  "string",
+  "null"
+]
```

Changed1 schema field changedOct 23, 2026

changedOutput schema / properties / anchor / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "company_id": {
-        "type": "string"
-      },
-      "registered_name": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "trade_name": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "required": [
-      "company_id",
-      "registered_name",
-      "trade_name"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "company_id": {
+        "type": "string"
+      },
+      "registered_name": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "registry_country": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "The own company's registry country as an ISO 3166-1 alpha-2 code, null when unknown."
+      },
+      "trade_name": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "required": [
+      "company_id",
+      "registered_name",
+      "trade_name",
+      "registry_country"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed1 schema field changedOct 19, 2026

changedOutput schema / properties / own_companies / items / properties / basis / enum

Previous value: -[
-  "anchor",
-  "holder",
-  "self_candidate"
-]New value: +[
+  "anchor",
+  "holder",
+  "confirmed",
+  "self_candidate"
+]

Changed3 schema fields changedOct 15, 2026

addedOutput schema / properties / own_companies

Added value: +{
+  "description": "The companies the workspace counts as itself, anchor first, then holders, then self-candidates. Filter mine-versus-theirs by the company_id of every anchor and holder row, never by anchor alone. Empty when the workspace has none.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "basis": {
+        "description": "Why the workspace counts this company as itself. anchor: the confirmed own company. holder: the company that holds a connected account; proven, even while anchor is null. self_candidate: a detection, not proof; mention it as possible only.",
+        "enum": [
+          "anchor",
+          "holder",
+          "self_candidate"
+        ],
+        "type": "string"
+      },
+      "company_id": {
+        "type": "string"
+      },
+      "registered_name": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "trade_name": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "required": [
+      "company_id",
+      "registered_name",
+      "trade_name",
+      "basis"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / own_companies_complete

Added value: +{
+  "description": "True when own_companies is the whole own set. False when it was cut at a bound: a company missing from it may still be the workspace's own, so never classify a company as theirs from this list.",
+  "type": "boolean"
+}

changedOutput schema / required

Previous value: -[
-  "anchor",
-  "candidates",
-  "own_identity",
-  "success"
-]New value: +[
+  "anchor",
+  "own_companies_complete",
+  "own_companies",
+  "candidates",
+  "own_identity",
+  "success"
+]

Changed2 schema fields changedOct 14, 2026

addedInput schema / properties / subtitle

Added value: +{
+  "description": "Supporting line under the card's heading. At most 240 characters. Omit to keep the default wording; an empty string is rejected rather than rendered blank.",
+  "maxLength": 240,
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / properties / title

Added value: +{
+  "description": "Heading for the card, written from what the user asked for (e.g. \"Create a workspace for your company\" for \"Create a workspace for my company\"). The card is drawn only for a request that names no company, so the heading names none. At most 120 characters. Omit to keep the default heading; an empty string is rejected rather than rendered as a blank heading.",
+  "maxLength": 120,
+  "minLength": 1,
+  "type": "string"
+}

Changed5 schema fields changedOct 13, 2026

addedOutput schema / properties / candidates / items / properties / adoption_preview_counts

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "accounts": {
+          "additionalProperties": false,
+          "properties": {
+            "capped": {
+              "type": "boolean"
+            },
+            "count": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "count",
+            "capped"
+          ],
+          "type": "object"
+        },
+        "documents": {
+          "additionalProperties": false,
+          "properties": {
+            "capped": {
+              "type": "boolean"
+            },
+            "count": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "count",
+            "capped"
+          ],
+          "type": "object"
+        },
+        "tasks": {
+          "additionalProperties": false,
+          "properties": {
+            "capped": {
+              "type": "boolean"
+            },
+            "count": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "count",
+            "capped"
+          ],
+          "type": "object"
+        },
+        "transactions": {
+          "additionalProperties": false,
+          "properties": {
+            "capped": {
+              "type": "boolean"
+            },
+            "count": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "count",
+            "capped"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "documents",
+        "tasks",
+        "transactions",
+        "accounts"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "How much of the company's history confirming it would bring in, per kind: documents, tasks, transactions and accounts. capped true means the count stopped at its ceiling, so say more than that number. Null when it is not known yet (no tax id on the candidate, or the preview was skipped)."
+}

changedOutput schema / properties / candidates / items / properties / confirmable_reason / anyOf

Previous value: -[
-  {
-    "enum": [
-      "not_open",
-      "not_surfaceable",
-      "not_primary",
-      "already_confirmed",
-      "not_grounded"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "not_open",
+      "not_surfaceable",
+      "not_primary",
+      "already_confirmed",
+      "not_grounded",
+      "existing_workspace_not_offered"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / candidates / items / properties / existing_workspace_id

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "An existing workspace the person manages whose company matches this candidate, offered to attach instead of minting a duplicate. Null on every row the offer classifier did not clear."
+}

addedOutput schema / properties / candidates / items / properties / existing_workspace_relation

Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "child",
+        "top_level"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "How the offered workspace relates to this one. child: it is already an active child. top_level: attaching links it under this workspace. Null whenever existing_workspace_id is."
+}

changedOutput schema / properties / candidates / items / required

Previous value: -[
-  "candidate_id",
-  "company_id",
-  "registered_name",
-  "trade_name",
-  "role",
-  "state",
-  "confidence_score",
-  "domain",
-  "remote_logo_url",
-  "country",
-  "business_type",
-  "confirmable",
-  "confirmable_reason"
-]New value: +[
+  "candidate_id",
+  "company_id",
+  "registered_name",
+  "trade_name",
+  "role",
+  "state",
+  "confidence_score",
+  "domain",
+  "remote_logo_url",
+  "country",
+  "business_type",
+  "confirmable",
+  "confirmable_reason",
+  "existing_workspace_id",
+  "existing_workspace_relation",
+  "adoption_preview_counts"
+]

Changed1 schema field changedOct 12, 2026

changedOutput schema / properties / newly_connected / description

Previous value: -"Tools that connected to this workspace since the last result and that no session was told about yet, oldest first. Present only when at least one tool is new. Start the reply with one line per entry, in the person's language: \"<name> is connected.\". Never fold several entries into one sentence. Each entry comes back once, on one result only: never repeat its line later."New value: +"Tools that connected to this workspace since the last result and that no session was told about yet, oldest first. Present only when at least one tool is new. The connected-line rule says when to tell an entry; when it does, one line per entry, in the person's language: \"<name> is connected.\". Never fold several entries into one sentence. Each entry comes back once, on one result only: never repeat its line later."

Changed1 schema field changedOct 9, 2026

changedOutput schema / properties / own_identity / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "ask_kind": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "When decision is ask, what is being asked: companies_or_clients (pick the real own company among several), conflicting_anchor_identity (evidence disagrees with the anchor), pending_identifier (a named company lacks a legal identifier), confirm_entity (one named company is proposed; confirm it is the user's own)."
-      },
-      "company_id": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "The company the verdict proposes or anchors on, when one was named."
-      },
-      "company_ids": {
-        "description": "Public ids of every company subject the verdict surfaced — the proposal and ask subjects.",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "decision": {
-        "anyOf": [
-          {
-            "enum": [
-              "propose",
-              "ask",
-              "none"
-            ],
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "The own-identity detector's last completed verdict for this workspace — propose (a company worth proposing), ask (ambiguity a person must resolve), or none. Null when no detection pass has settled yet."
-      },
-      "pending": {
-        "description": "True while an identity-resolution pass is queued or in flight — a fresher decision may follow; re-read after it settles.",
-        "type": "boolean"
-      },
-      "reason": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "The audit reason the verdict carries, in the resolver-reason vocabulary."
-      },
-      "registry_candidates": {
-        "description": "For an ask whose companies lack a legal identifier: the one registry entry a lookup found for a company, when exactly one matched. A lead for the user's registry pick, not a confirmed identity; its identifier is withheld.",
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "company_id": {
-              "description": "The company a registry entry was found for.",
-              "type": "string"
-            },
-            "country": {
-              "type": "string"
-            },
-            "name": {
-              "type": "string"
-            },
-            "scheme": {
-              "description": "The kind of identifier the entry is known by, never its value.",
-              "type": "string"
-            }
-          },
-          "required": [
-            "company_id",
-            "scheme",
-            "name",
-            "country"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "suggestions": {
-        "description": "Ranked suggestions the detector folded — leads, not proposal cards; a person's pick is what admits one.",
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "company_id": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "rank": {
-              "type": "number"
-            },
-            "strength": {
-              "type": "number"
-            }
-          },
-          "required": [
-            "company_id",
-            "rank",
-            "strength"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "decision",
-      "reason",
-      "company_id",
-      "ask_kind",
-      "company_ids",
-      "suggestions",
-      "registry_candidates",
-      "pending"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "ask_kind": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "When decision is ask, what is being asked: companies_or_clients (pick the real own company among several), conflicting_anchor_identity (evidence disagrees with the anchor), pending_identifier (a named company lacks a legal identifier), confirm_entity (one named company is proposed; confirm it is the user's own)."
+      },
+      "company_id": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "The company the verdict proposes or anchors on, when one was named."
+      },
+      "company_ids": {
+        "description": "Public ids of every company subject the verdict surfaced — the proposal and ask subjects.",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "decision": {
+        "anyOf": [
+          {
+            "enum": [
+              "propose",
+              "ask",
+              "none"
+            ],
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "The own-identity detector's last completed verdict for this workspace — propose (a company worth proposing), ask (ambiguity a person must resolve), or none. Null when no detection pass has settled yet."
+      },
+      "holder_candidates": {
+        "description": "Registry entries a lookup found for bank holders the detector judged to be organisations, normally none or one. A lead for the user's registry pick, not a confirmed identity and not a proposal: it names no workspace company, decision can stay none beside it, and its identifier is withheld.",
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "country": {
+              "type": "string"
+            },
+            "name": {
+              "type": "string"
+            },
+            "scheme": {
+              "description": "The kind of identifier the entry is known by, never its value.",
+              "type": "string"
+            }
+          },
+          "required": [
+            "scheme",
+            "name",
+            "country"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "pending": {
+        "description": "True while an identity-resolution pass is queued or in flight — a fresher decision may follow; re-read after it settles.",
+        "type": "boolean"
+      },
+      "reason": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "The audit reason the verdict carries, in the resolver-reason vocabulary."
+      },
+      "registry_candidates": {
+        "description": "For an ask whose companies lack a legal identifier: the one registry entry a lookup found for a company, when exactly one matched. A lead for the user's registry pick, not a confirmed identity; its identifier is withheld.",
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "company_id": {
+              "description": "The company a registry entry was found for.",
+              "type": "string"
+            },
+            "country": {
+              "type": "string"
+            },
+            "name": {
+              "type": "string"
+            },
+            "scheme": {
+              "description": "The kind of identifier the entry is known by, never its value.",
+              "type": "string"
+            }
+          },
+          "required": [
+            "company_id",
+            "scheme",
+            "name",
+            "country"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "suggestions": {
+        "description": "Ranked suggestions the detector folded — leads, not proposal cards; a person's pick is what admits one.",
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "company_id": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "rank": {
+              "type": "number"
+            },
+            "strength": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "company_id",
+            "rank",
+            "strength"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "decision",
+      "reason",
+      "company_id",
+      "ask_kind",
+      "company_ids",
+      "suggestions",
+      "registry_candidates",
+      "holder_candidates",
+      "pending"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed1 schema field changedOct 8, 2026

changedOutput schema / properties / own_identity / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "ask_kind": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "When decision is ask, what is being asked: companies_or_clients (pick the real own company among several), conflicting_anchor_identity (evidence disagrees with the anchor), pending_identifier (a named company lacks a legal identifier)."
-      },
-      "company_id": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "The company the verdict proposes or anchors on, when one was named."
-      },
-      "company_ids": {
-        "description": "Public ids of every company subject the verdict surfaced — the proposal and ask subjects.",
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "decision": {
-        "anyOf": [
-          {
-            "enum": [
-              "propose",
-              "ask",
-              "none"
-            ],
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "The own-identity detector's last completed verdict for this workspace — propose (a company worth proposing), ask (ambiguity a person must resolve), or none. Null when no detection pass has settled yet."
-      },
-      "pending": {
-        "description": "True while an identity-resolution pass is queued or in flight — a fresher decision may follow; re-read after it settles.",
-        "type": "boolean"
-      },
-      "reason": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "The audit reason the verdict carries, in the resolver-reason vocabulary."
-      },
-      "suggestions": {
-        "description": "Ranked suggestions the detector folded — leads, not proposal cards; a person's pick is what admits one.",
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "company_id": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "rank": {
-              "type": "number"
-            },
-            "strength": {
-              "type": "number"
-            }
-          },
-          "required": [
-            "company_id",
-            "rank",
-            "strength"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "decision",
-      "reason",
-      "company_id",
-      "ask_kind",
-      "company_ids",
-      "suggestions",
-      "pending"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "ask_kind": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "When decision is ask, what is being asked: companies_or_clients (pick the real own company among several), conflicting_anchor_identity (evidence disagrees with the anchor), pending_identifier (a named company lacks a legal identifier), confirm_entity (one named company is proposed; confirm it is the user's own)."
+      },
+      "company_id": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "The company the verdict proposes or anchors on, when one was named."
+      },
+      "company_ids": {
+        "description": "Public ids of every company subject the verdict surfaced — the proposal and ask subjects.",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "decision": {
+        "anyOf": [
+          {
+            "enum": [
+              "propose",
+              "ask",
+              "none"
+            ],
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "The own-identity detector's last completed verdict for this workspace — propose (a company worth proposing), ask (ambiguity a person must resolve), or none. Null when no detection pass has settled yet."
+      },
+      "pending": {
+        "description": "True while an identity-resolution pass is queued or in flight — a fresher decision may follow; re-read after it settles.",
+        "type": "boolean"
+      },
+      "reason": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "The audit reason the verdict carries, in the resolver-reason vocabulary."
+      },
+      "registry_candidates": {
+        "description": "For an ask whose companies lack a legal identifier: the one registry entry a lookup found for a company, when exactly one matched. A lead for the user's registry pick, not a confirmed identity; its identifier is withheld.",
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "company_id": {
+              "description": "The company a registry entry was found for.",
+              "type": "string"
+            },
+            "country": {
+              "type": "string"
+            },
+            "name": {
+              "type": "string"
+            },
+            "scheme": {
+              "description": "The kind of identifier the entry is known by, never its value.",
+              "type": "string"
+            }
+          },
+          "required": [
+            "company_id",
+            "scheme",
+            "name",
+            "country"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "suggestions": {
+        "description": "Ranked suggestions the detector folded — leads, not proposal cards; a person's pick is what admits one.",
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "company_id": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "rank": {
+              "type": "number"
+            },
+            "strength": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "company_id",
+            "rank",
+            "strength"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "decision",
+      "reason",
+      "company_id",
+      "ask_kind",
+      "company_ids",
+      "suggestions",
+      "registry_candidates",
+      "pending"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed5 schema fields changedOct 8, 2026

addedInput schema / properties / idempotency_key

Added value: +{
+  "description": "Optional client-supplied key. A retried write with the same key returns the original result instead of re-applying the operation.",
+  "maxLength": 255,
+  "minLength": 1,
+  "type": "string"
+}

changedInput schema / properties / workspace_id / description

Previous value: -"Target workspace. Omit when the token authorizes one workspace. Required when it authorizes several: this read reports one workspace's own figures and will not choose which."New value: +"Target workspace. Omit when the token authorizes one workspace. Required when it authorizes several — a write lands in exactly one workspace and this call would not say which."

addedInput schema / properties / workspace_scope

Added value: +{
+  "description": "Restrict this call to the family: the token's primary workspace plus the company workspaces under it that you are a member of. Unrelated authorized workspaces drop out of the read; row reads merge across the family, while a per-workspace figure still reports exactly one workspace.",
+  "enum": [
+    "family"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / own_identity

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "ask_kind": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "When decision is ask, what is being asked: companies_or_clients (pick the real own company among several), conflicting_anchor_identity (evidence disagrees with the anchor), pending_identifier (a named company lacks a legal identifier)."
+        },
+        "company_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The company the verdict proposes or anchors on, when one was named."
+        },
+        "company_ids": {
+          "description": "Public ids of every company subject the verdict surfaced — the proposal and ask subjects.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "decision": {
+          "anyOf": [
+            {
+              "enum": [
+                "propose",
+                "ask",
+                "none"
+              ],
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The own-identity detector's last completed verdict for this workspace — propose (a company worth proposing), ask (ambiguity a person must resolve), or none. Null when no detection pass has settled yet."
+        },
+        "pending": {
+          "description": "True while an identity-resolution pass is queued or in flight — a fresher decision may follow; re-read after it settles.",
+          "type": "boolean"
+        },
+        "reason": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The audit reason the verdict carries, in the resolver-reason vocabulary."
+        },
+        "suggestions": {
+          "description": "Ranked suggestions the detector folded — leads, not proposal cards; a person's pick is what admits one.",
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "company_id": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "rank": {
+                "type": "number"
+              },
+              "strength": {
+                "type": "number"
+              }
+            },
+            "required": [
+              "company_id",
+              "rank",
+              "strength"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "decision",
+        "reason",
+        "company_id",
+        "ask_kind",
+        "company_ids",
+        "suggestions",
+        "pending"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "The own-identity module's decision for this workspace, or null when the workspace row could not be read. A decision is a detection output, never a confirmed anchor — only anchor is confirmed."
+}

changedOutput schema / required

Previous value: -[
-  "anchor",
-  "candidates",
-  "success"
-]New value: +[
+  "anchor",
+  "candidates",
+  "own_identity",
+  "success"
+]

Changed1 schema field changedOct 6, 2026

addedOutput schema / properties / newly_connected

Added value: +{
+  "description": "Tools that connected to this workspace since the last result and that no session was told about yet, oldest first. Present only when at least one tool is new. Start the reply with one line per entry, in the person's language: \"<name> is connected.\". Never fold several entries into one sentence. Each entry comes back once, on one result only: never repeat its line later.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "name": {
+        "type": "string"
+      },
+      "service_id": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "name",
+      "service_id"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Changed4 schema fields changedSep 22, 2026

addedInput schema / properties / conversation_id

Added value: +{
+  "description": "The conversation id returned by the previous Well result, in its meta under well/conversation_id, in its structuredContent, or in its JSON text block. Pass it back on every call in the same conversation, including a call a card makes, so the chosen workspace and the earlier answers still apply. It decides the conversation on its own: nothing the host states about the session replaces it. Omit it only on the first call of a conversation.",
+  "type": "string"
+}

addedOutput schema / properties / conversation_id

Added value: +{
+  "description": "The conversation this result belongs to. Pass it back as the conversation_id argument on every later Well call in the same conversation.",
+  "type": "string"
+}

addedOutput schema / properties / conversation_id_note

Added value: +{
+  "description": "Present only when the server opened a fresh lane, stating that no choice recorded earlier was read.",
+  "type": "string"
+}

addedOutput schema / properties / conversation_id_source

Added value: +{
+  "description": "Where the conversation id came from: the host's own request meta, the caller's argument, or a fresh lane the server opened.",
+  "enum": [
+    "host_meta",
+    "argument",
+    "minted"
+  ],
+  "type": "string"
+}

Changed7 schema fields changedSep 16, 2026

addedOutput schema / properties / candidates / items / properties / business_type

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "The company's legal form (SAS, Inc, GmbH), when known."
+}

addedOutput schema / properties / candidates / items / properties / confirmable

Added value: +{
+  "description": "Whether well_create_company_workspace accepts this candidate now. False for a name-only detected candidate with no groundable identity, or one that has left the surfaced set.",
+  "type": "boolean"
+}

addedOutput schema / properties / candidates / items / properties / confirmable_reason

Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "not_open",
+        "not_surfaceable",
+        "not_primary",
+        "already_confirmed",
+        "not_grounded"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Why confirmable is false, null when true. not_grounded: no registry or tax identifier to mint from; ask the user to search the registry and pick the verified entry. not_open: no longer the surfaced candidate; re-read the own-company list before acting. Others: not_primary, already_confirmed, not_surfaceable."
+}

addedOutput schema / properties / candidates / items / properties / country

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "The company's country, for a light detail panel."
+}

addedOutput schema / properties / candidates / items / properties / domain

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "The company's domain, a logo source and a display fallback."
+}

addedOutput schema / properties / candidates / items / properties / remote_logo_url

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "A resolved logo url when one is known; null otherwise."
+}

changedOutput schema / properties / candidates / items / required

Previous value: -[
-  "candidate_id",
-  "company_id",
-  "registered_name",
-  "trade_name",
-  "role",
-  "state",
-  "confidence_score"
-]New value: +[
+  "candidate_id",
+  "company_id",
+  "registered_name",
+  "trade_name",
+  "role",
+  "state",
+  "confidence_score",
+  "domain",
+  "remote_logo_url",
+  "country",
+  "business_type",
+  "confirmable",
+  "confirmable_reason"
+]

AddedSep 15, 2026

TDQS

A4.4/5.0

Behavior4/5

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

Annotations only declare readOnlyHint=false and destructiveHint=false; the description adds substantial context the annotations cannot: a new workspace is minted from the pick while the current one stays intact, the card footer performs the mint on click so the agent must never mint it itself, and the wait holds the turn open for up to a minute. The one gap is that it doesn't restate why the tool is non-read-only beyond the mint behavior, but the side effects are otherwise well disclosed.

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 warning blocks are scannable. It is somewhat verbose — the wait instruction is stated and then cross-referenced to `next_step` — but every block carries a distinct operational constraint rather than filler.

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?

For a UI-drawing mutation tool with an output schema and full schema coverage, the description covers the trigger conditions, the mandatory follow-up wait, the side effect on the workspace, and the prohibition on auto-picking. Nothing an agent needs to invoke it correctly is missing.

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 description coverage is 100%, so the schema already explains title, subtitle, workspace_id, conversation_id, idempotency_key and workspace_scope. The description adds only the indirect hint that the card is drawn for a request naming no company, which relates loosely to the title/subtitle guidance already in the schema.

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?

States a concrete verb and resource: draw a card of detected company candidates with per-tile confidence and a registry search, so the user picks their company. It explicitly separates itself from `well_get_own_company`, which 'draws nothing', so an agent can route between them without opening either schema.

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

Usage Guidelines5/5

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

Names the exact triggering conditions (zero-company membership workspace, or user says the company set is wrong) and the alternative for read-only values (`well_get_own_company`). It also prescribes the follow-up call (`well_wait_for_selection({ kind: "company_pick" })`) and forbids inferring or choosing the company for the user.

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

All Well 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?