Skip to main content
Glama

Start useful customer work

start_onboarding
Read-only

Read saved choices, entry context and workspace evidence for one useful customer result. preferences saves explicit personal choices, never collection or write authority. Reuse accessible data and the team's setup. A useful brief or draft needs no CRM write. Setup is optional; admins confirm via finalize_workspace_setup. Only explicit collection consent permits start_import:true; then read again. Blank and CSV choices do not authorize email collection.

When to use: Start or resume useful customer work. Setup remains optional.

Example: Start Capable

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_onboarding"
  }
}

Input Schema

NameRequiredDescriptionDefault
sourcesNoWith start_import:true. Default: granted read sources. Never enables OAuth/scheduling.
preferencesNoExplicit choices only; [] clears. Omit for a read.
start_importNoExplicit collection consent only. Default false; a read never starts collection.
source_providerNoWith start_import:true. Default: connected.

Output Schema

NameRequiredDescriptionDefault
stateNo
guidanceNo
checklistNo
user_journeyNoFull preferences; enums as input, plus primary need/workflow and stage.
workspace_idNo
entry_contextNo
next_questionNo
prepared_taskNo
get_started_urlNo
import_evidenceNo
available_motionsNo
preferences_savedNo
available_templatesNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / prepared_task
      Added value: +{
      +  "type": "string"
      +}
  2. Changed18 schema fields changed
    • addedInput schema / properties / preferences
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Explicit choices only; [] clears. Omit for a read.",
      +  "properties": {
      +    "agent": {
      +      "anyOf": [
      +        {
      +          "enum": [
      +            "claude",
      +            "chatgpt",
      +            "copilot"
      +          ],
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "audience": {
      +      "anyOf": [
      +        {
      +          "enum": [
      +            "solo",
      +            "team",
      +            "rollout",
      +            "offices"
      +          ],
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "needs": {
      +      "items": {
      +        "enum": [
      +          "follow-ups",
      +          "prepare",
      +          "organize"
      +        ],
      +        "type": "string"
      +      },
      +      "maxItems": 3,
      +      "type": "array"
      +    },
      +    "path": {
      +      "anyOf": [
      +        {
      +          "enum": [
      +            "email",
      +            "blank",
      +            "csv"
      +          ],
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "skippedSteps": {
      +      "items": {
      +        "enum": [
      +          "welcome",
      +          "channels",
      +          "knowledge",
      +          "need",
      +          "workflow",
      +          "audience",
      +          "paths",
      +          "sources",
      +          "csv",
      +          "connect",
      +          "first"
      +        ],
      +        "type": "string"
      +      },
      +      "maxItems": 11,
      +      "type": "array"
      +    },
      +    "teamSize": {
      +      "anyOf": [
      +        {
      +          "enum": [
      +            "just-me",
      +            "2-5",
      +            "6-20",
      +            "21-plus"
      +          ],
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "workflows": {
      +      "items": {
      +        "enum": [
      +          "inbox",
      +          "notes",
      +          "spreadsheet",
      +          "crm"
      +        ],
      +        "type": "string"
      +      },
      +      "maxItems": 4,
      +      "type": "array"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / source_provider
      Added value: +{
      +  "description": "With start_import:true. Default: connected.",
      +  "enum": [
      +    "google",
      +    "microsoft"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / sources
      Added value: +{
      +  "description": "With start_import:true. Default: granted read sources. Never enables OAuth/scheduling.",
      +  "items": {
      +    "enum": [
      +      "email",
      +      "calendar"
      +    ],
      +    "type": "string"
      +  },
      +  "maxItems": 2,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • changedInput schema / properties / start_import / description
      Previous value: -"True only with explicit permission to import the connected inbox and calendar. Default false; a plain read never starts collection."New value: +"Explicit collection consent only. Default false; a read never starts collection."
    • addedOutput schema / properties / preferences_saved
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / user_journey / description
      Added value: +"Full preferences; enums as input, plus primary need/workflow and stage."
    • removedOutput schema / properties / user_journey / properties / agent
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "enum": [
      -        "claude",
      -        "chatgpt",
      -        "copilot"
      -      ],
      -      "type": "string"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ]
      -}
    • removedOutput schema / properties / user_journey / properties / audience
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "enum": [
      -        "solo",
      -        "team",
      -        "rollout"
      -      ],
      -      "type": "string"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ]
      -}
    • removedOutput schema / properties / user_journey / properties / need
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "enum": [
      -        "follow-ups",
      -        "prepare",
      -        "organize"
      -      ],
      -      "type": "string"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ]
      -}
    • addedOutput schema / properties / user_journey / properties / needs
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • removedOutput schema / properties / user_journey / properties / path
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "enum": [
      -        "email",
      -        "blank",
      -        "csv"
      -      ],
      -      "type": "string"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ]
      -}
    • addedOutput schema / properties / user_journey / properties / skippedSteps
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • removedOutput schema / properties / user_journey / properties / stage
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "enum": [
      -        "welcome",
      -        "audience",
      -        "need",
      -        "workflow",
      -        "paths",
      -        "connect",
      -        "first",
      -        "workspace"
      -      ],
      -      "type": "string"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ]
      -}
    • removedOutput schema / properties / user_journey / properties / teamSize
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "enum": [
      -        "just-me",
      -        "2-5",
      -        "6-20",
      -        "21-plus"
      -      ],
      -      "type": "string"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ]
      -}
    • removedOutput schema / properties / user_journey / properties / usefulResult
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "enum": [
      -        "brief",
      -        "draft",
      -        "organized"
      -      ],
      -      "type": "string"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ]
      -}
    • removedOutput schema / properties / user_journey / properties / workflow
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "enum": [
      -        "inbox",
      -        "notes",
      -        "spreadsheet",
      -        "crm"
      -      ],
      -      "type": "string"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ]
      -}
    • addedOutput schema / properties / user_journey / properties / workflows
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • removedOutput schema / properties / user_journey / required
      Removed value: -[
      -  "need",
      -  "workflow",
      -  "path",
      -  "agent",
      -  "stage"
      -]
  3. Changed1 schema field changed
    • changedOutput schema / properties / user_journey / properties / agent / anyOf
      Previous value: -[
      -  {
      -    "enum": [
      -      "claude",
      -      "chatgpt"
      -    ],
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "enum": [
      +      "claude",
      +      "chatgpt",
      +      "copilot"
      +    ],
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  4. Changed1 schema field changed
    • removedInput schema / $schema
      Removed value: -"https://json-schema.org/draft/2020-12/schema"
  5. Changed25 schema fields changed
    • removedOutput schema / $schema
      Removed value: -"https://json-schema.org/draft/2020-12/schema"
    • removedOutput schema / additionalProperties
      Removed value: -{}
    • removedOutput schema / properties / available_motions / items / additionalProperties
      Removed value: -false
    • removedOutput schema / properties / available_templates / items / additionalProperties
      Removed value: -false
    • removedOutput schema / properties / checklist / items / additionalProperties
      Removed value: -false
    • removedOutput schema / properties / entry_context / additionalProperties
      Removed value: -false
    • removedOutput schema / properties / import_evidence / additionalProperties
      Removed value: -false
    • removedOutput schema / properties / import_evidence / properties / accounts / additionalProperties
      Removed value: -false
    • removedOutput schema / properties / import_evidence / properties / accounts / properties / top / items / additionalProperties
      Removed value: -false
    • removedOutput schema / properties / import_evidence / properties / accounts / properties / top / items / properties / domain / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / import_evidence / properties / accounts / properties / top / items / properties / domain / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / import_evidence / properties / accounts / properties / top / items / properties / industry / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / import_evidence / properties / accounts / properties / top / items / properties / industry / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / import_evidence / properties / candidates / items / additionalProperties
      Removed value: -false
    • removedOutput schema / properties / import_evidence / properties / candidates / items / properties / evidence / additionalProperties
      Removed value: -false
    • removedOutput schema / properties / import_evidence / properties / contacts / additionalProperties
      Removed value: -false
    • removedOutput schema / properties / import_evidence / properties / touches / additionalProperties
      Removed value: -false
    • removedOutput schema / properties / state / additionalProperties
      Removed value: -{}
    • removedOutput schema / properties / state / properties / framework / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / state / properties / framework / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / state / properties / id / pattern
      Removed value: -"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    • removedOutput schema / properties / state / properties / name / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / state / properties / name / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / user_journey / additionalProperties
      Removed value: -false
    • removedOutput schema / properties / workspace_id / pattern
      Removed value: -"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
  6. Changed3 schema fields changed
    • changedInput schema / properties / start_import / description
      Previous value: -"On an empty workspace, pass true once to fetch the connected inbox and calendar; the read itself never writes. Default false."New value: +"True only with explicit permission to import the connected inbox and calendar. Default false; a plain read never starts collection."
    • addedOutput schema / properties / entry_context
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "kind": {
      +      "enum": [
      +        "creator",
      +        "joining",
      +        "unknown"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "kind"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / user_journey
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "agent": {
      +      "anyOf": [
      +        {
      +          "enum": [
      +            "claude",
      +            "chatgpt"
      +          ],
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "audience": {
      +      "anyOf": [
      +        {
      +          "enum": [
      +            "solo",
      +            "team",
      +            "rollout"
      +          ],
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "need": {
      +      "anyOf": [
      +        {
      +          "enum": [
      +            "follow-ups",
      +            "prepare",
      +            "organize"
      +          ],
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "path": {
      +      "anyOf": [
      +        {
      +          "enum": [
      +            "email",
      +            "blank",
      +            "csv"
      +          ],
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "stage": {
      +      "anyOf": [
      +        {
      +          "enum": [
      +            "welcome",
      +            "audience",
      +            "need",
      +            "workflow",
      +            "paths",
      +            "connect",
      +            "first",
      +            "workspace"
      +          ],
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "teamSize": {
      +      "anyOf": [
      +        {
      +          "enum": [
      +            "just-me",
      +            "2-5",
      +            "6-20",
      +            "21-plus"
      +          ],
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "usefulResult": {
      +      "anyOf": [
      +        {
      +          "enum": [
      +            "brief",
      +            "draft",
      +            "organized"
      +          ],
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "workflow": {
      +      "anyOf": [
      +        {
      +          "enum": [
      +            "inbox",
      +            "notes",
      +            "spreadsheet",
      +            "crm"
      +          ],
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    }
      +  },
      +  "required": [
      +    "need",
      +    "workflow",
      +    "path",
      +    "agent",
      +    "stage"
      +  ],
      +  "type": "object"
      +}
  7. First observed

TDQS

B3.2/5.0
Behavior2/5

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

The description does disclose substantial behavior beyond the schema: consent gating for start_import, that blank/CSV choices never authorize email collection, that sources never enable OAuth or scheduling, and that no CRM write is needed for a brief. However, it also states that "preferences saves explicit personal choices" and that start_import:true begins collection, which are state changes that the readOnlyHint:true annotation denies — a meaningful inconsistency an agent could act on unsafely.

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

Conciseness3/5

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

The core constraint (read by default, import only on explicit consent) is stated early, which is good front-loading, but the prose is dense, policy-flavored, and repeats the consent idea across several sentences. Phrases like "one useful customer result" and "Reuse accessible data and the team's setup" read as guidance for a human rather than a specification for a calling agent.

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

Completeness3/5

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

With an output schema, full annotation coverage, and 100% schema descriptions, most of the burden is already carried elsewhere, and the description adds the important consent/safety rules. What is missing is an unambiguous statement of when the tool mutates state versus purely reads, which is exactly the ambiguity that conflicts with readOnlyHint.

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 already 100%, yet the description still adds meaning: preferences records only explicit personal choices and carries no collection authority, start_import requires explicit consent and defaults false, and blank/CSV path values explicitly do not authorize email collection. Those are policy constraints the schema's field descriptions do not carry on their own.

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

Purpose3/5

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

The description says the tool reads "saved choices, entry context and workspace evidence," which signals a read/resume operation, but the framing is abstract jargon ("one useful customer result," "workspace evidence") that never plainly states "onboarding." The name is start_onboarding while the title is "Start useful customer work," and neither the description nor the title cleanly separates it from show_workspace_setup or finalize_workspace_setup, so an agent gets the general idea but not a crisp verb+resource statement.

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

Usage Guidelines4/5

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

It gives an explicit "When to use: Start or resume useful customer work" and repeatedly clarifies that setup is optional, plus it names finalize_workspace_setup as the path requiring admin confirmation. The read-vs-import branching ("then read again," "a useful brief or draft needs no CRM write") is real guidance. It stops short of naming the closest read-only sibling to use instead when no onboarding context is wanted.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources