All MCP tools
MCP tools · Calls and campaigns
list_calls
Lists the organization's Finn phone calls: who was called, status, duration, sentiment and campaign. Filter by campaign, Finn, status, direction or time. No transcripts here; use get_call for one call.
- Scope needed
- voice:read or voice:write
- Changes data
- No, read only
- Held for approval
- No
- Available to
- Switched on per organization (MCP task tools and call tools)
- Release
- Planned for R2 (2026-11-24)
Inputs
| Name | Type | Description |
|---|---|---|
| org_id | string | Organization id. Leave out when the user belongs to one organization; otherwise the error lists theirs. |
| campaign_id | string | Only calls from this campaign (from list_campaigns). |
| finn_id | string | Only calls made by this Finn. |
| status | string[] | Any of these statuses: completed, failed, busy, no-answer, canceled, voicemail, in-progress, ringing. |
| direction | enum: inbound | outbound | Only inbound or only outbound calls. |
| from | string | Only calls at or after this ISO-8601 time. |
| to | string | Only calls at or before this ISO-8601 time. |
| limit | number | Page size, 1-100. Default 25. |
| offset | number | Items to skip, for the next page. |