Skip to main content

Example Use Cases

We've outlined some instances of ways to use the Bandwidth MCP Server below. Continue reading for sample prompts, necessary tools to enable, and environment variables to configure for specific actions.

These are just a few examples; the package has over 40 tools available for use!

Messaging

Example Prompts

  • "Send a text message to +19198675309 that says 'Hey Jenny, what's up?'"
  • "Why did my most recent text message fail?"

Tools to Enable

  • listMessages - Get info about messages you just sent or other messages on your account.
  • createMessage - Send SMS or MMS messages
  • createMultiChannelMessage - Send multi-channel messages (mostly for RBM messaging)

Relevant Environment Variables

  • BW_ACCOUNT_ID
  • BW_MESSAGING_APPLICATION_ID
  • BW_NUMBER

End User Management

Example Prompts

  • "Add a business end-user with the name My Company"
  • "What features are restricted for 123 My Address in Raleigh, NC?"

Tools to Enable

  • listEndUserTypes - List all End user types and accepted metadata
  • listEndUserActivationRequirements - List requirements for End user activation
  • createComplianceEndUser - Create an End user
  • validateAddress - Validate an address and get excluded features

Relevant Environment Variables

  • BW_ACCOUNT_ID

Phone Number Lookup

Example Prompts

  • "What information can you tell me about +19195551234?"
  • "Look up the following phone numbers: +19195551234, +19195551235, +19195551236..."

Tools to Enable

  • createLookup - Create a phone number lookup request
  • getLookupStatus - Get status of a phone number lookup request

Relevant Environment Variables

  • BW_ACCOUNT_ID

Multi-factor Authentication

Example Prompts

  • "Generate an SMS MFA code and send it to +19195551234"
  • "Is the MFA code 123456 valid?"

Tools to Enable

  • generateMessagingCode - Used to generate and send an MFA code via SMS
  • generateVoiceCode - Use to generate and send an MFA code via a phone call
  • verifyCode - Verify an MFA code sent with one of the previous tools

Relevant Environment Variables

  • BW_ACCOUNT_ID
  • BW_NUMBER
  • BW_VOICE_APPLICATION_ID
  • BW_MESSAGING_APPLICATION_ID