Phone Number Tools - Bizzy Documentation

The Bizzy MCP server provides 2 tools for inspecting the phone numbers connected to your organization. Use these tools to discover which numbers are available or to look up a specific number by ID.

getPhoneNumber

Get details of a specific phone number by ID. Permission: phone-numbers:read Parameters:

Name	Type	Required	Description
`phoneNumberId`	string (UUID)	Yes	The ID of the phone number to retrieve

Returns: The phone number object, or null if not found.

listPhoneNumbers

List phone numbers for the organization with optional filtering. Permission: phone-numbers:read Parameters:

Name	Type	Required	Default	Description
`limit`	number	No	100	Maximum number of results
`offset`	number	No	0	Offset for pagination
`provider`	string	No	-	Filter by phone provider. Valid values: `telnyx`, `twilio`
`status`	string	No	-	Filter by phone number status. Valid values: `pending`, `active`, `disabled`, `errored`, `deleted`

Returns:

{
  "phoneNumbers": [...],
  "count": 4,
  "limit": 100,
  "offset": 0
}

Next Steps

Email Address Tools

Inspect email addresses available for sending

Authentication

Learn how MCP clients authenticate to the server

Last modified on May 30, 2026

Message Tools Task Tools

⌘I

​getPhoneNumber

​listPhoneNumbers

​Next Steps

Email Address Tools

Authentication

getPhoneNumber

listPhoneNumbers

Next Steps