Start a New Company
start_new_companyBegin a brand-new company formation alongside any existing companies the customer already has — call when the customer explicitly asks to form a SECOND (or further) company. Creates an empty in-progress Company row, links it to the customer, and pins it as the active company so the next tool calls operate on it. The response's nextStep is the new company's first formation step. The previously active company is untouched and remains in list_companies, and switch_active_company makes it active again.
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": "start_new_company"
}
}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 | |
| nextStep | No | The step the formation flow now waits on; null once formation is complete. | |
| companyId | No | KSUID of the newly-created company, now the active company | |
| nextQuestion | No | The customer-facing question for nextStep; null once formation is complete. | |
| conversation_id | No | This conversation's handle. Pass it unchanged as conversation_id on every later call. | |
| suggestedNextStep | No | The tool for the new company's first formation step |