Skip to main content
All MCP tools

MCP tools · Calls and campaigns

list_phone_numbers

Lists the phone numbers the organization owns, newest first, with each number's id, provider and which Finn answers it. A number's id is the phone_number_id for start_campaign. There is no total: ask for the next page with offset until a page has fewer than limit items.

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 phone number and audience lists)

Inputs

NameTypeDescription
org_idstringOrganization id. Leave out when the user belongs to one organization; otherwise the error lists theirs.
limitnumberPage size, 1-100. Default 25.
offsetnumberItems to skip, for the next page.