List Sending Numbers
list_sending_numbersList the phone numbers this account can send text messages from, whether each can send right now, and which one send_message uses by default (isDefault). Pass a number's number as send_message's from to send from it instead. A new account usually has a main toll-free number awaiting carrier approval plus a temporary trial number that only allows a small number of messages; once the main number is approved it becomes the default.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_sending_numbers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| error | No | ||
| status | Yes | ||
| context | No | Additional context about why the call was blocked | |
| numbers | No | ||
| success | Yes | ||
| errorCode | No | Machine-readable error code. 'ONBOARDING_REQUIRED' means the account has not finished brand registration. 'NO_SENDING_NUMBER' means no number on the account can send yet; 'SENDING_NUMBER_NOT_FOUND' / 'SENDING_NUMBER_UNAVAILABLE' mean the requested `from` number is not on the account or can't send. 'AUTH_FAILED', 'RATE_LIMITED', 'UPSTREAM_ERROR' and 'UPSTREAM_UNAVAILABLE' are Mobile Text Alerts API failures. | |
| nextSteps | No | Explicit recovery guidance for the calling agent | |
| statusText | Yes |