Check Formation Progress
get_company_onboarding_statusCanonical 'where am I?' entry point — call this ONCE per user session, at the start, right after the OAuth handshake. No arguments required; customerId is read from the bearer. Returns the customer's progress: completedSteps, blockers (unmet prerequisites in flow order), suggestedNextStep (the tool for the step the flow waits on), and nextStep ({tool, missingFields, description}) with nextQuestion, all null once formation is complete.
DO NOT call this before every formation call. Each formation tool's response already carries nextStep, so calling this between steps only adds latency and burns rate limit.
Only call this AGAIN when one of these is true: (a) the user returns mid-flow after a long pause and asks 'where are we?', (b) you need to verify state after an unexpected error or a failed call, or (c) the active company changed through switch_active_company. Outside those cases, treat the first call's state as authoritative for the rest of the session.
Derivation mirrors /web's onboarding routing (Company.gql): each step is marked completed when its corresponding Company / Customer field is populated. If the customer has no active company yet (post-OAuth, pre-formation), nextStep is start_formation.
If the response contains error: true or nextStep looks inconsistent with the user's actual progress (e.g. the company name was just saved but nextStep is the company name again), the upstream data fetch likely transiently failed. Wait ~10 seconds and call this tool again before deciding what to do next — do NOT redo earlier steps the user has already completed.
Formation flow, in order: start_formation, create_checkout_session, verify_payment, save_company_details (industries from search_industries), submit_formation. Each response's nextStep is the step the flow now waits on.
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": "get_company_onboarding_status"
}
}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 |
|---|---|---|---|
| No | Customer email | ||
| error | No | true if an error occurred | |
| message | No | Human-readable status | |
| blockers | No | Prerequisites still unmet, in flow order. Same vocabulary as the `missing` array submit_for_review returns. Empty array when formation is fully complete. | |
| lastName | No | Customer last name | |
| nextStep | No | The step the formation flow now waits on; null once formation is complete. | |
| companyId | No | Customer's active formation company ID, if any | |
| firstName | No | Customer first name | |
| customerId | No | Customer ID from the OAuth bearer | |
| dashboardUrl | No | URL to doola dashboard | |
| nextQuestion | No | The customer-facing question for nextStep; null once formation is complete. | |
| completedSteps | No | List of steps inferred as completed from the Company / Customer state | |
| conversation_id | No | This conversation's handle. Pass it unchanged as conversation_id on every later call. | |
| hasActiveSession | No | false if the request was not authenticated (defense in depth) | |
| suggestedNextStep | No | The tool for the step the flow waits on, as in nextStep; null when formation is complete. | |
| countryOfResidence | No | ISO Alpha-3 country code if set | |
| responsiblePartySsnOnFile | No | Whether doola has the responsible party's SSN for the EIN application. Only ever this boolean: no tool returns the SSN or any part of it. |