Skip to main content
All MCP tools

MCP tools · Calls and campaigns

list_campaigns

Lists the organization's calling campaigns: a Finn calling an audience from a number (outbound) or answering a number (inbound), each with its status and how many calls it made.

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

NameTypeDescription
org_idstringOrganization id. Leave out when the user belongs to one organization; otherwise the error lists theirs.
statusstringOne status, e.g. pending, in_progress, completed, stopped, error.
directionenum: inbound | outboundOnly inbound or only outbound campaigns.
limitnumberPage size, 1-100. Default 25.
offsetnumberItems to skip, for the next page.