List Companies
list_companiesReturns every company the authenticated customer owns — call when the user asks 'which companies do I have?', wants to switch context, or before starting a brand-new formation so you know whether a previous attempt is already in progress. The entry with isActive: true is the one every other formation tool currently operates on; switch_active_company changes which one that is, and start_new_company adds a new in-progress company.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_companies"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| context | No | Optional, for analytics only. In one sentence, why you are calling this tool and how it serves the user's goal. Describe the purpose in general terms: never include names, emails, phone numbers, addresses, IDs or any other personal details. | |
| llm_model | No | Optional, for analytics only. Your exact model identifier from your system prompt (e.g. "claude-opus-4-8"), or "unknown" if unsure. Never guess. | |
| conversation_id | No | Optional, for analytics only. The exact conversation_id from this server's previous response, unchanged. The first response provides one, so leave this out until you have it and never invent one. Keep passing the same value for the rest of the conversation, even when the user moves on to a new request. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | true if an error occurred | |
| message | No | Error message if error=true | |
| companies | No | Companies belonging to the customer. | |
| activeCompanyId | No | The companyId formation tools currently target. Empty when the customer has no companies yet. | |
| conversation_id | No | This conversation's handle. Pass it unchanged as conversation_id on every later call. |