All MCP tools
MCP tools · Operator agents and approvals
start_operator_case
Asks an Operator agent to work a case on one record (a contact, a deal, an inbound email). Once started the agent acts on its own, under the approvals its owner set. The organization may hold the start for a person to approve first.
- Scope needed
- operator:write
- Changes data
- Yes
- Held for approval
- Can be. The call returns a pending approval and nothing happens until a person in your organization approves it.
- Available to
- Switched on per organization (MCP task tools)
Inputs
| Name | Type | Description |
|---|---|---|
| org_id | string | Organization id. Leave out when the user belongs to one organization; otherwise the error lists theirs. |
| agent_idrequired | string | The agent id (a UUID), from list_operator_agents. |
| subjectrequired | object | The record the case works on: { type, ref }, e.g. type `contact`, `deal` or `email` and ref a CRM record id or email address. |
| title | string | A short name for the case. |
| data | object | Facts the agent should start with. |
| memory | string | Notes for the agent, in plain words. |