All MCP tools
MCP tools · Operator agents and approvals
list_operator_cases
Lists the organization's Finn Operator cases (jobs an agent is working or worked), newest first: id, agent, subject, status and outcome. Filter by agent, status, owner, contact or outcome, or search. Read one with get_case_status.
- Scope needed
- operator:read or operator:write or operator:build
- Changes data
- No, read only
- Held for approval
- No
- 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_id | string | Only cases of this agent (a UUID). |
| status | string | A case status, e.g. `open`, `waiting`, `resolved`. |
| owner_id | string | Only cases this teammate owns (a user id). |
| contact_id | string | Only cases about this contact. |
| outcome_key | string | Only cases that ended with this outcome. |
| q | string | Search text over the case title and subject. |
| before | string | next_before from the previous page. |
| limit | number | Page size, 1-100. Default 25. |