Twilio

Twilio MCP Server for Cloudflare Workers

Available Tools

46 tools available in the Twilio MCP server. Each tool can be called by AI assistants to perform specific actions.

twilio_get_account

Get details of the current Twilio account.

Args:

format: Response format ('json' or 'markdown')

Returns: Account details including status, type, and friendly name.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

twilio_update_account

Update the current Twilio account settings.

Args:

friendlyName: (Optional) New friendly name for the account
status: (Optional) Account status - 'active', 'suspended', or 'closed'

Returns: The updated account object.

{
  "type": "object",
  "properties": {
    "status": {
      "enum": [
        "active",
        "suspended",
        "closed"
      ],
      "type": "string",
      "description": "Account status"
    },
    "friendlyName": {
      "type": "string",
      "description": "New account name"
    }
  }
}

twilio_list_subaccounts

List all subaccounts under the main account.

Args:

format: Response format ('json' or 'markdown')

Returns: List of subaccounts with their details.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

twilio_create_subaccount

Create a new subaccount under the main account.

Subaccounts allow you to segment usage, phone numbers, and billing.

Args:

friendlyName: A descriptive name for the subaccount

Returns: The created subaccount object with its own SID and auth token.

{
  "type": "object",
  "required": [
    "friendlyName"
  ],
  "properties": {
    "friendlyName": {
      "type": "string",
      "description": "Subaccount name"
    }
  }
}

twilio_make_call

Make an outbound phone call via Twilio.

Args:

to: Destination phone number in E.164 format
from: Your Twilio phone number in E.164 format
url: (Optional) TwiML URL for call instructions
twiml: (Optional) Inline TwiML for call instructions
timeout: (Optional) Seconds to wait for answer (default: 60)
record: (Optional) Whether to record the call
machineDetection: (Optional) 'Enable' or 'DetectMessageEnd' for AMD
statusCallback: (Optional) URL for call status webhooks

Note: Either 'url' or 'twiml' must be provided.

Returns: The created call object with SID and status.

{
  "type": "object",
  "required": [
    "to",
    "from"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Destination phone number in E.164 format"
    },
    "url": {
      "type": "string",
      "description": "TwiML URL for call instructions"
    },
    "from": {
      "type": "string",
      "description": "Your Twilio phone number"
    },
    "twiml": {
      "type": "string",
      "description": "Inline TwiML"
    },
    "record": {
      "type": "boolean",
      "description": "Record the call"
    },
    "timeout": {
      "type": "integer",
      "maximum": 600,
      "minimum": 1,
      "description": "Seconds to wait for answer"
    },
    "statusCallback": {
      "type": "string",
      "description": "Status webhook URL"
    }
  }
}

twilio_list_calls

List voice calls from your Twilio account.

Args:

to: (Optional) Filter by destination number
from: (Optional) Filter by caller number
status: (Optional) Filter by status (queued, ringing, in-progress, completed, busy, failed, no-answer, canceled)
startTimeAfter: (Optional) Filter calls started after this date (YYYY-MM-DD)
startTimeBefore: (Optional) Filter calls started before this date
pageSize: Number of calls to return (default: 20, max: 1000)
format: Response format ('json' or 'markdown')

Returns: Paginated list of calls.

{
  "type": "object",
  "properties": {
    "to": {
      "type": "string",
      "description": "Filter by destination number"
    },
    "from": {
      "type": "string",
      "description": "Filter by caller number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "pageSize": {
      "type": "integer",
      "default": 20,
      "maximum": 1000,
      "minimum": 1,
      "description": "Number of calls"
    },
    "startTimeAfter": {
      "type": "string",
      "description": "Filter calls after date"
    },
    "startTimeBefore": {
      "type": "string",
      "description": "Filter calls before date"
    }
  }
}

twilio_get_call

Get details of a specific call by SID.

Args:

callSid: The call SID (starts with CA)
format: Response format ('json' or 'markdown')

Returns: The call object with all details.

{
  "type": "object",
  "required": [
    "callSid"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "callSid": {
      "type": "string",
      "description": "Call SID"
    }
  }
}

twilio_update_call

Modify an in-progress call or cancel a queued call.

Args:

callSid: The call SID to modify
status: (Optional) Set to 'canceled' or 'completed' to end the call
url: (Optional) New TwiML URL for call instructions
twiml: (Optional) New inline TwiML

Returns: The updated call object.

{
  "type": "object",
  "required": [
    "callSid"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "New TwiML URL"
    },
    "twiml": {
      "type": "string",
      "description": "New inline TwiML"
    },
    "status": {
      "enum": [
        "canceled",
        "completed"
      ],
      "type": "string",
      "description": "End the call"
    },
    "callSid": {
      "type": "string",
      "description": "Call SID to modify"
    }
  }
}

twilio_list_conversations

List all conversations in your account.

Args:

format: Response format ('json' or 'markdown')

Returns: List of conversations with their details.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

twilio_create_conversation

Create a new conversation.

Args:

friendlyName: (Optional) A descriptive name
uniqueName: (Optional) A unique identifier
messagingServiceSid: (Optional) Messaging Service for SMS participants
state: (Optional) Initial state - 'active', 'inactive', or 'closed'

Returns: The created conversation object.

{
  "type": "object",
  "properties": {
    "state": {
      "enum": [
        "active",
        "inactive",
        "closed"
      ],
      "type": "string",
      "description": "Initial state"
    },
    "uniqueName": {
      "type": "string",
      "description": "Unique identifier"
    },
    "friendlyName": {
      "type": "string",
      "description": "Descriptive name"
    },
    "messagingServiceSid": {
      "type": "string",
      "description": "Messaging Service SID"
    }
  }
}

twilio_get_conversation

Get details of a specific conversation.

Args:

conversationSid: The conversation SID (starts with CH)
format: Response format ('json' or 'markdown')

Returns: The conversation object with all details.

{
  "type": "object",
  "required": [
    "conversationSid"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "conversationSid": {
      "type": "string",
      "description": "Conversation SID"
    }
  }
}

twilio_update_conversation

Update a conversation.

Args:

conversationSid: The conversation SID to update
friendlyName: (Optional) New descriptive name
uniqueName: (Optional) New unique identifier
state: (Optional) New state - 'active', 'inactive', or 'closed'

Returns: The updated conversation object.

{
  "type": "object",
  "required": [
    "conversationSid"
  ],
  "properties": {
    "state": {
      "enum": [
        "active",
        "inactive",
        "closed"
      ],
      "type": "string",
      "description": "New state"
    },
    "uniqueName": {
      "type": "string",
      "description": "New unique name"
    },
    "friendlyName": {
      "type": "string",
      "description": "New name"
    },
    "conversationSid": {
      "type": "string",
      "description": "Conversation SID"
    }
  }
}

twilio_delete_conversation

Delete a conversation.

WARNING: This will delete all messages and participants.

Args:

conversationSid: The conversation SID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "conversationSid"
  ],
  "properties": {
    "conversationSid": {
      "type": "string",
      "description": "Conversation SID"
    }
  }
}

twilio_list_conversation_participants

List participants in a conversation.

Args:

conversationSid: The conversation SID
format: Response format ('json' or 'markdown')

Returns: List of participants in the conversation.

{
  "type": "object",
  "required": [
    "conversationSid"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "conversationSid": {
      "type": "string",
      "description": "Conversation SID"
    }
  }
}

twilio_redact_message

Redact the body of a message (set to empty for compliance).

Args:

messageSid: The message SID to redact

Returns: The updated message with redacted body.

{
  "type": "object",
  "required": [
    "messageSid"
  ],
  "properties": {
    "messageSid": {
      "type": "string",
      "description": "Message SID to redact"
    }
  }
}

twilio_add_conversation_participant

Add a participant to a conversation.

Args:

conversationSid: The conversation SID
identity: (Optional) Chat user identity
messagingBindingAddress: (Optional) SMS participant phone number
messagingBindingProxyAddress: (Optional) Twilio phone for SMS proxy

For SMS participants, provide both messagingBindingAddress and messagingBindingProxyAddress. For chat participants, provide identity.

Returns: The created participant object.

{
  "type": "object",
  "required": [
    "conversationSid"
  ],
  "properties": {
    "identity": {
      "type": "string",
      "description": "Chat user identity"
    },
    "conversationSid": {
      "type": "string",
      "description": "Conversation SID"
    },
    "messagingBindingAddress": {
      "type": "string",
      "description": "SMS participant phone"
    },
    "messagingBindingProxyAddress": {
      "type": "string",
      "description": "Twilio proxy phone"
    }
  }
}

twilio_remove_conversation_participant

Remove a participant from a conversation.

Args:

conversationSid: The conversation SID
participantSid: The participant SID to remove

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "conversationSid",
    "participantSid"
  ],
  "properties": {
    "participantSid": {
      "type": "string",
      "description": "Participant SID"
    },
    "conversationSid": {
      "type": "string",
      "description": "Conversation SID"
    }
  }
}

twilio_list_conversation_messages

List messages in a conversation.

Args:

conversationSid: The conversation SID
format: Response format ('json' or 'markdown')

Returns: List of messages in the conversation.

{
  "type": "object",
  "required": [
    "conversationSid"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "conversationSid": {
      "type": "string",
      "description": "Conversation SID"
    }
  }
}

twilio_send_conversation_message

Send a message to a conversation.

Args:

conversationSid: The conversation SID
body: The message text
author: (Optional) Message author identity

Returns: The created message object.

{
  "type": "object",
  "required": [
    "conversationSid",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Message text"
    },
    "author": {
      "type": "string",
      "description": "Author identity"
    },
    "conversationSid": {
      "type": "string",
      "description": "Conversation SID"
    }
  }
}

twilio_lookup

Look up information about a phone number.

Args:

phoneNumber: Phone number to lookup (E.164 or national format)
fields: (Optional) Data packages to include:
- 'line_type_intelligence': Carrier and line type info
- 'caller_name': Caller ID name (US only)
- 'sim_swap': Recent SIM swap detection
- 'call_forwarding': Call forwarding status
- 'sms_pumping_risk': SMS fraud risk score
- 'reassigned_number': Number reassignment check
countryCode: (Optional) Country code for national format numbers
format: Response format ('json' or 'markdown')

Note: Some fields incur additional charges. Basic validation is free.

Returns: Phone number details with requested intelligence data.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "countryCode": {
      "type": "string",
      "description": "Country code for national format"
    },
    "phoneNumber": {
      "type": "string",
      "description": "Phone number to lookup"
    }
  }
}

twilio_validate_phone_number

Validate a phone number format (free operation).

Args:

phoneNumber: Phone number to validate
countryCode: (Optional) Country code for national format numbers
format: Response format ('json' or 'markdown')

Returns: Validation result with E.164 and national format.

{
  "type": "object",
  "required": [
    "phoneNumber"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "countryCode": {
      "type": "string",
      "description": "Country code"
    },
    "phoneNumber": {
      "type": "string",
      "description": "Phone number to validate"
    }
  }
}

twilio_get_line_type

Get line type and carrier information for a phone number.

Args:

phoneNumber: Phone number to lookup
format: Response format ('json' or 'markdown')

Returns: Line type (mobile, landline, VoIP, etc.) and carrier details.

{
  "type": "object",
  "required": [
    "phoneNumber"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "phoneNumber": {
      "type": "string",
      "description": "Phone number to lookup"
    }
  }
}

twilio_check_sms_pumping_risk

Check if a phone number has SMS pumping fraud risk.

Args:

phoneNumber: Phone number to check
format: Response format ('json' or 'markdown')

Returns: SMS pumping risk score and carrier risk category.

{
  "type": "object",
  "required": [
    "phoneNumber"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "phoneNumber": {
      "type": "string",
      "description": "Phone number to check"
    }
  }
}

twilio_send_sms

Send an SMS or MMS message via Twilio.

Args:

to: Destination phone number in E.164 format (e.g., +15551234567)
from: Your Twilio phone number in E.164 format
body: The message text
mediaUrl: (Optional) URL(s) of media to send (for MMS)
messagingServiceSid: (Optional) Messaging Service SID instead of from number
statusCallback: (Optional) URL to receive status webhooks

Returns: The created message object with SID and status.

{
  "type": "object",
  "required": [
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Destination phone number in E.164 format"
    },
    "body": {
      "type": "string",
      "description": "Message text"
    },
    "from": {
      "type": "string",
      "description": "Your Twilio phone number"
    },
    "mediaUrl": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Media URLs for MMS"
    },
    "statusCallback": {
      "type": "string",
      "description": "Webhook URL for status updates"
    },
    "messagingServiceSid": {
      "type": "string",
      "description": "Messaging Service SID"
    }
  }
}

twilio_list_messages

List SMS/MMS messages from your Twilio account.

Args:

to: (Optional) Filter by destination number
from: (Optional) Filter by sender number
dateSent: (Optional) Filter by date sent (YYYY-MM-DD)
pageSize: Number of messages to return (default: 20, max: 1000)
format: Response format ('json' or 'markdown')

Returns: Paginated list of messages.

{
  "type": "object",
  "properties": {
    "to": {
      "type": "string",
      "description": "Filter by destination number"
    },
    "from": {
      "type": "string",
      "description": "Filter by sender number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "dateSent": {
      "type": "string",
      "description": "Filter by date sent (YYYY-MM-DD)"
    },
    "pageSize": {
      "type": "integer",
      "default": 20,
      "maximum": 1000,
      "minimum": 1,
      "description": "Number of messages"
    }
  }
}

twilio_get_message

Get details of a specific message by SID.

Args:

messageSid: The message SID (starts with SM or MM)
format: Response format ('json' or 'markdown')

Returns: The message object with all details.

{
  "type": "object",
  "required": [
    "messageSid"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "messageSid": {
      "type": "string",
      "description": "Message SID"
    }
  }
}

twilio_delete_message

Delete a message from your account.

Args:

messageSid: The message SID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "messageSid"
  ],
  "properties": {
    "messageSid": {
      "type": "string",
      "description": "Message SID to delete"
    }
  }
}

twilio_list_phone_numbers

List all phone numbers in your Twilio account.

Args:

format: Response format ('json' or 'markdown')

Returns: List of your Twilio phone numbers with capabilities and configuration.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

twilio_get_phone_number

Get details of a specific phone number by SID.

Args:

phoneNumberSid: The phone number SID (starts with PN)
format: Response format ('json' or 'markdown')

Returns: The phone number object with all configuration details.

{
  "type": "object",
  "required": [
    "phoneNumberSid"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "phoneNumberSid": {
      "type": "string",
      "description": "Phone number SID"
    }
  }
}

twilio_search_phone_numbers

Search for available phone numbers to purchase.

Args:

countryCode: ISO country code (e.g., 'US', 'GB', 'CA')
type: Number type - 'Local', 'TollFree', or 'Mobile'
areaCode: (Optional) Filter by area code
contains: (Optional) Pattern to match (e.g., 'FLOWERS')
smsEnabled: (Optional) Filter by SMS capability
mmsEnabled: (Optional) Filter by MMS capability
voiceEnabled: (Optional) Filter by voice capability
inRegion: (Optional) Filter by state/region
inPostalCode: (Optional) Filter by postal code
nearNumber: (Optional) Find numbers near this number
pageSize: Number of results (default: 20)

Returns: List of available phone numbers matching criteria.

{
  "type": "object",
  "required": [
    "countryCode",
    "type"
  ],
  "properties": {
    "type": {
      "enum": [
        "Local",
        "TollFree",
        "Mobile"
      ],
      "type": "string",
      "description": "Number type"
    },
    "areaCode": {
      "type": "string",
      "description": "Area code filter"
    },
    "contains": {
      "type": "string",
      "description": "Pattern to match"
    },
    "inRegion": {
      "type": "string",
      "description": "State/region"
    },
    "pageSize": {
      "type": "integer",
      "default": 20,
      "maximum": 1000,
      "minimum": 1,
      "description": "Number of results"
    },
    "mmsEnabled": {
      "type": "boolean",
      "description": "MMS capability"
    },
    "nearNumber": {
      "type": "string",
      "description": "Find numbers near this number"
    },
    "smsEnabled": {
      "type": "boolean",
      "description": "SMS capability"
    },
    "countryCode": {
      "type": "string",
      "description": "ISO country code (e.g., US)"
    },
    "inPostalCode": {
      "type": "string",
      "description": "Postal code"
    },
    "voiceEnabled": {
      "type": "boolean",
      "description": "Voice capability"
    }
  }
}

twilio_purchase_phone_number

Purchase a phone number for your account.

Args:

phoneNumber: The phone number to purchase in E.164 format
friendlyName: (Optional) A descriptive name for the number
voiceUrl: (Optional) URL to fetch TwiML for incoming calls
smsUrl: (Optional) URL to fetch TwiML for incoming SMS
statusCallback: (Optional) URL for status webhooks

Returns: The purchased phone number object.

{
  "type": "object",
  "required": [
    "phoneNumber"
  ],
  "properties": {
    "smsUrl": {
      "type": "string",
      "description": "TwiML URL for SMS"
    },
    "voiceUrl": {
      "type": "string",
      "description": "TwiML URL for calls"
    },
    "phoneNumber": {
      "type": "string",
      "description": "Phone number in E.164 format"
    },
    "friendlyName": {
      "type": "string",
      "description": "Descriptive name"
    },
    "statusCallback": {
      "type": "string",
      "description": "Status webhook URL"
    }
  }
}

twilio_update_phone_number

Update configuration for a phone number.

Args:

phoneNumberSid: The phone number SID to update
friendlyName: (Optional) New descriptive name
voiceUrl: (Optional) New TwiML URL for calls
voiceFallbackUrl: (Optional) Fallback TwiML URL
smsUrl: (Optional) New TwiML URL for SMS
smsFallbackUrl: (Optional) Fallback SMS URL
statusCallback: (Optional) New status webhook URL

Returns: The updated phone number object.

{
  "type": "object",
  "required": [
    "phoneNumberSid"
  ],
  "properties": {
    "smsUrl": {
      "type": "string",
      "description": "TwiML URL for SMS"
    },
    "voiceUrl": {
      "type": "string",
      "description": "TwiML URL for calls"
    },
    "friendlyName": {
      "type": "string",
      "description": "New descriptive name"
    },
    "phoneNumberSid": {
      "type": "string",
      "description": "Phone number SID to update"
    },
    "smsFallbackUrl": {
      "type": "string",
      "description": "Fallback SMS URL"
    },
    "statusCallback": {
      "type": "string",
      "description": "Status webhook URL"
    },
    "voiceFallbackUrl": {
      "type": "string",
      "description": "Fallback TwiML URL"
    }
  }
}

twilio_release_phone_number

Release (delete) a phone number from your account.

WARNING: This action cannot be undone. The number will be released back to the pool.

Args:

phoneNumberSid: The phone number SID to release

Returns: Confirmation of release.

{
  "type": "object",
  "required": [
    "phoneNumberSid"
  ],
  "properties": {
    "phoneNumberSid": {
      "type": "string",
      "description": "Phone number SID to release"
    }
  }
}

twilio_list_recordings

List voice recordings from your account.

Args:

callSid: (Optional) Filter by call SID
conferenceSid: (Optional) Filter by conference SID
dateCreatedAfter: (Optional) Filter recordings after date (YYYY-MM-DD)
dateCreatedBefore: (Optional) Filter recordings before date
pageSize: Number of recordings to return (default: 20, max: 1000)
format: Response format ('json' or 'markdown')

Returns: Paginated list of recordings.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "callSid": {
      "type": "string",
      "description": "Filter by call SID"
    },
    "pageSize": {
      "type": "integer",
      "default": 20,
      "maximum": 1000,
      "minimum": 1,
      "description": "Number of recordings"
    },
    "conferenceSid": {
      "type": "string",
      "description": "Filter by conference SID"
    },
    "dateCreatedAfter": {
      "type": "string",
      "description": "Filter after date"
    },
    "dateCreatedBefore": {
      "type": "string",
      "description": "Filter before date"
    }
  }
}

twilio_get_recording

Get details of a specific recording.

Args:

recordingSid: The recording SID (starts with RE)
format: Response format ('json' or 'markdown')

Returns: The recording object with details and media URL.

{
  "type": "object",
  "required": [
    "recordingSid"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "recordingSid": {
      "type": "string",
      "description": "Recording SID"
    }
  }
}

twilio_delete_recording

Delete a recording from your account.

WARNING: This action cannot be undone.

Args:

recordingSid: The recording SID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "recordingSid"
  ],
  "properties": {
    "recordingSid": {
      "type": "string",
      "description": "Recording SID to delete"
    }
  }
}

twilio_list_usage_records

Get usage records for your Twilio account.

Args:

category: (Optional) Filter by category:
- 'calls': Voice calls
- 'sms': SMS messages
- 'mms': MMS messages
- 'phonenumbers': Phone number charges
- 'recordings': Recording storage
- 'transcriptions': Transcription charges
- 'totalprice': Total charges (Many more categories available)
startDate: (Optional) Start date for usage period (YYYY-MM-DD)
endDate: (Optional) End date for usage period
includeSubaccounts: (Optional) Include subaccount usage
pageSize: Number of records to return (default: 20)
format: Response format ('json' or 'markdown')

Returns: Usage records with counts, usage amounts, and prices.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "endDate": {
      "type": "string",
      "description": "End date (YYYY-MM-DD)"
    },
    "category": {
      "type": "string",
      "description": "Usage category filter"
    },
    "pageSize": {
      "type": "integer",
      "default": 20,
      "maximum": 1000,
      "minimum": 1,
      "description": "Number of records"
    },
    "startDate": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    },
    "includeSubaccounts": {
      "type": "boolean",
      "description": "Include subaccount usage"
    }
  }
}

twilio_get_sms_usage

Get SMS usage records for your account.

Args:

startDate: (Optional) Start date (YYYY-MM-DD)
endDate: (Optional) End date (YYYY-MM-DD)
format: Response format ('json' or 'markdown')

Returns: SMS usage with count and pricing.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "endDate": {
      "type": "string",
      "description": "End date (YYYY-MM-DD)"
    },
    "startDate": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    }
  }
}

twilio_get_voice_usage

Get voice call usage records for your account.

Args:

startDate: (Optional) Start date (YYYY-MM-DD)
endDate: (Optional) End date (YYYY-MM-DD)
format: Response format ('json' or 'markdown')

Returns: Voice usage with minutes and pricing.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "endDate": {
      "type": "string",
      "description": "End date (YYYY-MM-DD)"
    },
    "startDate": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    }
  }
}

twilio_get_total_usage

Get total usage and costs for your account.

Args:

startDate: (Optional) Start date (YYYY-MM-DD)
endDate: (Optional) End date (YYYY-MM-DD)
includeSubaccounts: (Optional) Include subaccount usage
format: Response format ('json' or 'markdown')

Returns: Total usage across all categories with pricing.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "endDate": {
      "type": "string",
      "description": "End date (YYYY-MM-DD)"
    },
    "startDate": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    },
    "includeSubaccounts": {
      "type": "boolean",
      "description": "Include subaccounts"
    }
  }
}

twilio_send_verification

Send a verification code to a phone number or email.

Args:

serviceSid: Verify Service SID (starts with VA)
to: Destination phone number (E.164) or email address
channel: Delivery channel - 'sms', 'call', 'email', or 'whatsapp'
locale: (Optional) Locale for message (e.g., 'en', 'es', 'fr')
customCode: (Optional) Custom verification code (if enabled)

Returns: The verification object with SID and status.

{
  "type": "object",
  "required": [
    "serviceSid",
    "to",
    "channel"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Phone number or email"
    },
    "locale": {
      "type": "string",
      "description": "Locale for message"
    },
    "channel": {
      "enum": [
        "sms",
        "call",
        "email",
        "whatsapp"
      ],
      "type": "string",
      "description": "Delivery channel"
    },
    "customCode": {
      "type": "string",
      "description": "Custom verification code"
    },
    "serviceSid": {
      "type": "string",
      "description": "Verify Service SID"
    }
  }
}

twilio_check_verification

Check a verification code submitted by a user.

Args:

serviceSid: Verify Service SID
to: Phone number or email that was verified
code: The verification code to check

Returns: Verification check result with valid/invalid status.

{
  "type": "object",
  "required": [
    "serviceSid",
    "to",
    "code"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Phone number or email"
    },
    "code": {
      "type": "string",
      "description": "Verification code"
    },
    "serviceSid": {
      "type": "string",
      "description": "Verify Service SID"
    }
  }
}

twilio_list_verify_services

List all Verify Services in your account.

Args:

format: Response format ('json' or 'markdown')

Returns: List of Verify Services with configurations.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

twilio_create_verify_service

Create a new Verify Service.

Args:

friendlyName: A descriptive name for the service
codeLength: (Optional) Length of verification code (4-10, default: 6)
lookupEnabled: (Optional) Enable phone number lookup
skipSmsToLandlines: (Optional) Skip SMS for landlines, use voice
customCodeEnabled: (Optional) Allow custom verification codes

Returns: The created Verify Service object.

{
  "type": "object",
  "required": [
    "friendlyName"
  ],
  "properties": {
    "codeLength": {
      "type": "integer",
      "maximum": 10,
      "minimum": 4,
      "description": "Code length"
    },
    "friendlyName": {
      "type": "string",
      "description": "Service name"
    },
    "lookupEnabled": {
      "type": "boolean",
      "description": "Enable lookup"
    },
    "customCodeEnabled": {
      "type": "boolean",
      "description": "Allow custom codes"
    },
    "skipSmsToLandlines": {
      "type": "boolean",
      "description": "Skip SMS to landlines"
    }
  }
}

twilio_get_verify_service

Get details of a Verify Service.

Args:

serviceSid: The Verify Service SID
format: Response format ('json' or 'markdown')

Returns: The Verify Service object with configuration.

{
  "type": "object",
  "required": [
    "serviceSid"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "serviceSid": {
      "type": "string",
      "description": "Verify Service SID"
    }
  }
}

twilio_delete_verify_service

Delete a Verify Service.

WARNING: This will delete all verification data for this service.

Args:

serviceSid: The Verify Service SID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "serviceSid"
  ],
  "properties": {
    "serviceSid": {
      "type": "string",
      "description": "Verify Service SID"
    }
  }
}