# Telebroad MCP > Telebroad connects your business phone system, cloud PBX, and communication services directly to your AI client. It lets you manage everything in one chat: initiating calls, sending SMS messages, retrieving full call histories, and handling digital faxes via natural conversation. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** cloud-pbx, business-phone, sms-outreach, digital-fax, call-queues, unified-communications ## Description When you hook up your business phone system—voice calls, SMS, and faxes—to your agent using Telebroad, it lets you manage everything right in chat. You don't have to hop between ten different apps; you just talk to the bot. This server gives your AI client twelve specific tools so you can run complex comms operations with simple commands. **Managing Voice Calls** The `send_call` tool lets you initiate a voice call immediately, connecting you straight out to any number or internal extension you need. If you're checking on what's happening right now, you can use `list_active_calls` to see every single connection running across your accounts. You also have the ability to end an active line instantly; just run `hangup_call`. For keeping track of business movements, the `list_call_history` tool delivers a full record of all calls—incoming, outgoing, and those missed ones you gotta follow up on. **Handling SMS Messaging** To text someone, simply use `send_sms`, which sends a new message from an available line to any recipient. If you need to know what lines you're allowed to send texts from, check `list_sms_lines`. You can then run `list_sms_conversations` to get a list of every active chat thread you have going on. Once you pick a conversation, `get_sms_messages` pulls the entire content history for that specific thread so you've got all the details right there. **Processing Digital Faxes** For faxing stuff, the system keeps track of everything with `list_faxes`, showing both faxes sent and those received. If you need to send a document officially, run `send_fax` to transmit a digital fax using one of your authorized lines. **Accessing Directories and Logs** You can look up internal team numbers by running `list_phone_destinations`, which shows every extension available in the company directory. To check on your own user status, `get_profile` retrieves all your current Telebroad user profile information, like line assignments and settings. Finally, you've got the tools to manage SMS history (`list_sms_conversations`) and read specific messages via `get_sms_messages`, letting you track every detail of your communications stack from one place. ## Tools ### get_profile Retrieves your current Telebroad user profile information. ### get_sms_messages Gets the content of messages from a specific SMS conversation thread. ### hangup_call Ends an active phone call that is currently running. ### list_active_calls Shows all calls happening right now on your accounts. ### list_call_history Provides a log of past incoming, outgoing, and missed calls. ### list_faxes Lists the recent faxes that were sent or received through Telebroad. ### list_phone_destinations Shows all internal phone extensions available in your company directory. ### list_sms_conversations Retrieves a list of active SMS conversation threads you've had. ### list_sms_lines Lists the specific, authorized SMS lines you can send messages from. ### send_call Initiates and connects a voice call to a specified number or extension. ### send_fax Sends a digital fax document using one of your authorized faxes lines. ### send_sms Sends a new text message from an available SMS line to a recipient. ## Prompt Examples **Prompt:** ``` Show me my recent call history. ``` **Response:** ``` I've retrieved your call log. You had 3 recent calls: 'Incoming from +15550199' (Missed), 'Outgoing to John Doe' (Success, 5m), and 'Incoming from Unknown' (Success, 2m). Would you like to return any of these calls? ``` **Prompt:** ``` Send an SMS from my line +15550100 to +15550188: 'Meeting at 2 PM'. ``` **Response:** ``` SMS sent! I've transmitted the message 'Meeting at 2 PM' from +15550100 to the recipient +15550188. Your message has been queued for delivery. ``` **Prompt:** ``` List all internal extensions in my company. ``` **Response:** ``` Fetching extensions... I found 5 internal destinations: 101 (Sales), 102 (Support), 103 (Finance), and 2 staff extensions. Which one would you like to call? ``` ## Capabilities ### Manage Voice Calls Initiate outgoing voice calls, track active connections, or hang up a call using dedicated tools. ### Handle SMS Messaging Send new text messages and retrieve the full history of any specific conversation thread. ### Process Digital Faxes List all received and sent faxes, or send documents as official digital faxes from your lines. ### View Communication Logs Access comprehensive logs for call history, active calls, and SMS threads in one place. ### Coordinate Internal Teams Look up internal phone extensions and team destinations to ensure you dial the right number every time. ## Use Cases ### Client Follow-Up After Support A support agent needs to follow up with a client. The agent first runs `list_call_history` to confirm the last call was successful. Then, they use `get_sms_messages` to review the threads and finally send a summary via `send_sms`. Everything happens without leaving the chat window. ### Emergency Directory Lookup An office manager needs to reach Finance, but forgets the extension. They prompt the agent to run `list_phone_destinations`. The agent immediately provides a list of internal numbers, saving them from manually calling the main switchboard. ### Documenting a Vendor Agreement A sales rep needs to send an agreement. They use `send_fax` with the PDF attached and then run `list_faxes` immediately after to get confirmation that the document was successfully queued for sending. ### Checking Communication Scope A manager wants a full picture of activity. They check both `list_call_history` for voice contacts and `list_sms_conversations` to understand the scope of recent client communication across multiple channels. ## Benefits - See your entire communication history in one place. Instead of logging into separate apps, use `list_call_history` to pull call logs alongside text threads when you need context for a client review. - Automate outreach fast. Need to follow up? Use `send_sms` or `send_call` directly via your agent. It's faster than opening the phone app and dialing manually. - Never miss an important internal connection. Before calling, use `list_phone_destinations` to verify the correct extension for a team member, eliminating guesswork. - Maintain compliance records easily. Use `list_faxes` and `list_call_history` together. You get proof of both digital documents and voice contact in one session. - Handle complex status checks instantly. Running `get_profile` gives you immediate access to user settings, while `list_active_calls` lets you know if a line is already busy. ## How It Works The bottom line is you manage all calls, texts, and faxes without switching apps or opening a dashboard. 1. First, connect your AI client to the Telebroad MCP Server using your credentials. 2. Next, prompt your agent with a natural language request (e.g., 'What was my call history yesterday?'). 3. Finally, the agent executes the necessary tools (`list_call_history`) and provides you with an actionable summary. ## Frequently Asked Questions **How do I check my past calls using Telebroad MCP Server?** You use `list_call_history`. This single command pulls all your incoming, outgoing, and missed call records into one view for you to review. **Can I send a text message with Telebroad MCP Server?** Yes, you can. Just run the `send_sms` tool. You'll need to specify the recipient number and the content of your message. **What is the difference between listing calls and listing call history using Telebroad MCP Server?** The difference is time. `list_active_calls` tells you what’s happening right now. `list_call_history` gives you records from past interactions. **How do I find a team member's extension number with Telebroad MCP Server?** Use the `list_phone_destinations` tool. It queries your internal directory and lists all available extensions for your company. **How do I check my user account details using the `get_profile` tool in Telebroad MCP Server?** The `get_profile` tool fetches detailed metadata about your current Telebroad account. It returns information like your primary extensions, registered phone lines, and general user settings. **How does Telebroad MCP Server handle ending an ongoing conversation with the `hangup_call` tool?** The `hangup_call` tool immediately terminates any call that is currently active on your account. Your agent invokes this tool when you need to manually end a connection. **When using Telebroad MCP Server, how do I retrieve the full text from a specific SMS thread with `get_sms_messages`?** You pass the conversation ID and line number parameters into `get_sms_messages`. The tool returns all message payloads for that specific thread, allowing your agent to read the entire context. **What types of documents can I send using the `send_fax` tool in Telebroad MCP Server?** The `send_fax` function supports sending PDF documents from your authorized lines. This means you must provide a file path and the recipient's fax number for it to work. **Can I initiate a voice call using the AI?** Yes! Use the `send_call` tool and provide the destination phone number. Your agent will trigger the call through your Telebroad line instantly. **How do I see the history of my recent calls?** Run the `list_call_history` query. The agent will retrieve a log of all recent incoming, outgoing, and missed calls associated with your account. **Is it possible to send a PDF as a fax via AI?** Absolutely. Use the `send_fax` tool. Provide the recipient's fax number, your authorized fax line, and the public URL of the PDF document.