Phone Number Tools

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.

Phone numbers are not yet generally available. These two tools are only advertised over tools/list when phone is enabled for your organization — if you don’t see them, they aren’t part of your server’s tool set, and calling them by name will fail. Contact support to have phone enabled. The contact phone-number tools on the Contact Tools page are unaffected and always available.

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 August 9, 2026

Getting Started

Agent resources

getPhoneNumber

listPhoneNumbers

Next Steps

Email Address Tools

Authentication

​getPhoneNumber

​listPhoneNumbers

​Next Steps

Email Address Tools

Authentication

getPhoneNumber

listPhoneNumbers

Next Steps