get_account_phone_numbers

Retrieve all phone numbers linked to a Twilio subaccount using its Account SID for management and oversight.

Instructions

Get all phone numbers associated with a Twilio subaccount

Input Schema

TableJSON Schema

Name	Required	Description	Default
`account_sid`	Yes

Implementation Reference

twilio_manager_mcp.py:57-67 (handler)

The MCP tool handler function that executes the get_account_phone_numbers tool logic. It takes account_sid and delegates to AsyncTwilioManager.get_account_numbers.

async def get_account_phone_numbers_for_subaccount(account_sid: str) -> list[dict]:
    """
    Get all phone numbers associated with a Twilio subaccount
    Args:
        account_sid: The SID of the Twilio subaccount
    Returns:
        List of phone numbers and their details
    """
    async with async_twilio_manager:
        return await async_twilio_manager.get_account_numbers(account_sid)

twilio_manager_mcp.py:53-56 (registration)

The @mcp.tool decorator registration for the get_account_phone_numbers tool.

@mcp.tool(
    name="get_account_phone_numbers",
    description="Get all phone numbers associated with a Twilio subaccount",
)

api/async_twilio_api.py:86-119 (helper)

The core helper method in AsyncTwilioManager that fetches local and mobile incoming phone numbers from Twilio API for the given account_sid.

async def get_account_numbers(self, account_sid: Optional[str] = None) -> List[Dict]:
    """
    Get all phone numbers associated with a subaccount.

    Args:
        account_sid: The subaccount SID

    Returns:
        List of phone numbers and their details
    """
    try:
        numbers = []
        if account_sid:
            local_numbers = await self.client.api.v2010.accounts(
                account_sid
            ).incoming_phone_numbers.local.list_async()
            mobile_numbers = await self.client.api.v2010.accounts(
                account_sid
            ).incoming_phone_numbers.mobile.list_async()
        else:
            local_numbers = await self.client.incoming_phone_numbers.local.list_async()
            mobile_numbers = await self.client.incoming_phone_numbers.mobile.list_async()

        numbers.extend(
            [{**number.__dict__, "number_type": "national"} for number in local_numbers]
        )
        numbers.extend(
            [{**number.__dict__, "number_type": "mobile"} for number in mobile_numbers]
        )
        return numbers

    except Exception as e:
        self.logger.error(f"Failed to fetch phone numbers: {str(e)}")
        raise

TwilioManager MCP