# Toky MCP > Toky connects your cloud phone system directly into your AI workflow. It lets you manage business communications—calling, texting, and contact records—using natural conversation commands. You can list call history with `list_calls`, send texts via `send_sms`, or pull up specific customer details using `get_contact`. It’s all designed to handle complex comms tasks from any AI client. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** cloud-phone, call-recording, ivr, sms-automation, business-telephony, crm-integration ## Description Listen up. This MCP Server hooks your entire Toky cloud phone system right into your AI workflow. You manage all your business communications—calling, texting, and contact records—using nothing but natural conversation commands from any client. It lets your agent handle complex comms tasks without you lifting a finger. **Managing Contacts and Clients** You can treat your customer directory like it’s built into the AI itself. To see a full list of every person in your book, just run `list_contacts`. If you need to find out what kind of data is sitting there, `list_contacts` gives you an overview that lets you paginate through massive databases. When you know exactly who you're looking for, use `get_contact` to fetch the full details on any existing record by its ID. Need to add a new client? You just tell it to run `create_contact`, and it saves the whole new customer profile into your directory. **Handling Communications History** Tracking calls and voicemails is simple. To get an overview of all recorded call history, you use `list_calls`. If you need deep context—like who called, when they called, and what happened with that specific chat—you run `get_call` to pull every piece of metadata about one single phone interaction. For messages left on the line, you first check in with `list_voicemails`, which gives you a rundown of all recent recordings. To actually download and display the content from a specific voicemail, use `get_voicemail`. **Outreach and Team Directory** Sending quick texts is straightforward. You just tell it to send an SMS via `send_sms`, specifying the phone number and the message body; that text goes straight out of your Toky account. When you need to know about your team, this server keeps tabs on agents too. To see who's available or list your entire roster, run `list_agents`. If you need specific details—like a profile or status check—on one particular agent, use the `get_agent` tool. This setup lets your AI client handle everything: creating new contacts with `create_contact`, pulling up old call transcripts using `get_call`, keeping track of voicemails with `list_voicemails` and `get_voicemail`, listing out every agent or contact record, and sending texts directly through `send_sms`. You're running your whole comms operation from one spot. It’s built for speed. ## Tools ### create_contact Saves a new customer record into your Toky contact directory. ### get_agent Pulls specific profile details for one of your communication agents. ### get_call Retrieves all metadata and context for a single, specified phone call. ### get_contact Fetches the full details of one existing contact record by ID. ### get_voicemail Downloads and displays the content for a single voicemail message. ### list_agents Lists multiple agents, allowing you to paginate through your team directory. ### list_calls Provides an overview and pagination of all recorded call history entries. ### list_contacts Lists multiple contacts, allowing you to paginate through your customer database. ### list_voicemails Provides an overview and pagination of all recorded voicemail messages. ### send_sms Sends a text message to the specified phone number using your Toky account. ## Prompt Examples **Prompt:** ``` List all active agents in my Toky account. ``` **Response:** ``` I've retrieved your agents. You have 3 active users: 'Alex Rivera' (Available), 'Sarah Smith' (On a call), and 'Mike Ross'. Which one would you like more details on? ``` **Prompt:** ``` Show me the last 3 calls from today. ``` **Response:** ``` I've fetched the call history. Today you had: 1 Incoming from +15550199 (Missed), 1 Outgoing to John Doe (Success, 5m), and 1 Incoming from Unknown (Success, 2m). Shall I retrieve the recording for the John Doe call? ``` **Prompt:** ``` Send an SMS to 5511999999999 saying 'Your consultation is confirmed for tomorrow'. ``` **Response:** ``` SMS message sent! I've transmitted your confirmation text to 5511999999999. The transmission ID is SMS-88231. Your customer should receive it shortly. ``` ## Capabilities ### Send SMS messages You send a text message to a specific phone number using `send_sms`. ### Manage contact records You create, read, and list customer contacts using the `create_contact`, `get_contact`, or `list_contacts` tools. ### Retrieve call details You fetch specific data about a completed or missed call with `get_call`. ### Check voicemail status You retrieve the content and metadata of voicemails using `get_voicemail` or listing all recent messages via `list_voicemails`. ### Review communication history You list agent profiles (`list_agents`) to see who's available, and review past call logs using `list_calls`. ## Use Cases ### The Post-Discovery Follow-up A Sales Rep finishes a demo. Instead of copying down three details (name, company, best number), they ask their agent to 'Create contact for John Doe at XYZ Corp.' The agent runs `create_contact` and instantly logs the data. Then, they tell it to send an immediate follow-up using `send_sms`. Done in seconds. ### Triage a Support Ticket A Support Specialist receives a ticket about a recent call. They ask their agent to 'Pull up the last three calls for this customer.' The agent runs `list_calls`, showing success/fail status, and then runs `get_call` on the specific failed attempt to find out why. ### Audit Team Activity An Operations Manager needs to see who is available right now. They ask the agent to 'List all active agents.' The agent uses `list_agents` and provides a real-time status report, letting them know if they need to reassign coverage. ### Retrieve Missed Voicemails You realize you missed important client messages. You ask the agent to 'Show me my voicemails for last week.' It runs `list_voicemails`, and when you see a key message, you prompt it to run `get_voicemail` so you can read the content immediately. ## Benefits - Track full communication history instantly. Instead of logging into the phone dashboard to see call logs, just ask your agent to run `list_calls`. You get a structured summary right in your chat window. - Eliminate manual data entry for leads. When you make a new connection, use `create_contact` immediately through the AI command. The record gets added and synchronized without lifting a finger. - Handle follow-ups on the fly. Don't wait until morning to text someone. You can prompt your agent to execute `send_sms` right after a meeting ends, ensuring zero delay in client communication. - Get deep context immediately. If you get an unknown call, instead of guessing, ask for details using `get_call`. You instantly pull the metadata needed to know if it was missed or if someone left a message. - Keep track of voicemails easily. Instead of logging into a separate voicemail portal, use `list_voicemails` and then prompt the agent to run `get_voicemail` for the specific messages you need. ## How It Works The bottom line is, you treat complex phone system actions like simple chat commands. You don't have to jump between dashboards. 1. Subscribe to the Toky MCP Server and input your API key. 2. Tell your AI agent what you need (e.g., 'List all contacts in Chicago'). 3. The agent calls the necessary tool(s) (`list_contacts`, `get_contact`) and returns the data to complete your task. ## Frequently Asked Questions **How do I use the Toky MCP Server to send a text message?** To send an SMS, just tell your agent to 'Send a text to 5511999999999 saying hi.' The agent executes `send_sms`, and you get confirmation of the transmission ID. **Can I use the Toky MCP Server to find out who is available?** Yes. You ask your agent to 'List all agents,' which runs `list_agents` and gives you a real-time roster of your team's availability status. **What if I need details on an old phone call? Do I use get_call?** Yes, that’s the right tool. You provide the specific call ID to your agent, which then runs `get_call` and pulls all the metadata for you. **Is there a way to save a new client contact using Toky MCP Server?** Absolutely. Just tell your agent to 'Create a new contact' and provide the name, number, and company details. The agent runs `create_contact`. **If I need to check old messages, how does the `list_voicemails` tool help me retrieve details?** It lists all your voicemails and provides key metadata like the date, duration, and associated contact ID. This lets you quickly identify which recordings you need to review or summarize later. **When querying a large set of records, how should I handle pagination using tools like `list_contacts`?** You must include the `limit` and `offset` parameters in your call. This fetches data in controlled batches, preventing you from hitting rate limits or overwhelming the system with one massive request. **What specific profile information does the `get_agent` tool return for a team member?** It returns more than just their current status. You get details like their full name, assigned extension, and departmental role. This helps your agent confirm who they are interacting with. **What happens if I call `get_call` or `get_contact` using an ID that doesn't exist?** The tool returns a specific error code and message instead of failing silently. Your agent reads this response, giving you immediate feedback on why the data retrieval failed. **Can I see my recent call history via AI?** Yes! Use the `list_calls` tool. Your agent will retrieve the history of all incoming and outgoing calls, including durations and participant details. **How do I send an SMS to a customer using the AI?** Use the `send_sms` action. Provide the destination phone number and your message text. The agent will trigger the SMS transmission through your Toky account instantly. **Is it possible to check for new voicemails via AI?** Absolutely. Run the `list_voicemails` query. The agent will retrieve a list of all recorded voicemails, which you can then inspect for specific interaction details.