# Mitto MCP > Mitto automates global communication workflows directly from your AI agent. Send single or bulk SMS messages, secure accounts by sending and verifying Two-Factor Authentication (2FA) codes via SMS or voice, and validate phone numbers to ensure deliverability. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** sms-api, two-factor-authentication, otp-verification, global-messaging, number-lookup, telecom ## Description Connecting Mitto through Vinkius lets your AI client handle complex messaging tasks right where you write code. You can trigger large-scale outreach campaigns with a single command, sending bulk SMS messages globally while tracking which countries see the most activity. If an account needs securing, your agent handles the entire 2FA process: it sends the One-Time Password (OTP) and then waits for you to feed back the verified code using specific tools. Beyond messaging, Mitto helps with phone number hygiene. You can look up any given phone number to check its carrier information before sending a message, making sure your campaigns don't fail due to invalid numbers. Developers use this MCP to integrate robust communication and authentication into applications without ever leaving their chat window or IDE. ## Tools ### add_masked_number Attaches a privacy mask to an existing phone number record. ### add_masking_participant Adds a new user or entity that needs its communication identity masked. ### cancel_2fa Stops an ongoing Two-Factor Authentication code request for a specific user. ### create_masking_application Sets up a dedicated application layer to manage how numbers are masked and used. ### create_masking_context Creates a specific operational context for grouping related masking data. ### delete_masking_application Removes an established number masking application entirely. ### delete_masking_context Clears out a previously defined grouping of masked communication data. ### delete_masked_number Deletes a phone number that has been masked by the system. ### delete_masking_participant Removes a specified user from the list of participants involved in masking operations. ### get_2fa_usage Retrieves historical records detailing how often 2FA codes were requested and used. ### get_sms_usage_by_country Generates a breakdown of SMS message usage, grouped by the destination country. ### list_masking_applications Shows all currently active number masking applications set up in your account. ### list_masking_contexts Lists the available, defined grouping contexts for masked numbers. ### list_masked_numbers Retrieves a list of all phone numbers currently under a masking protocol. ### list_masking_participants Displays the names and IDs of every participant involved in number masking. ### lookup_number Checks a phone number to validate its format, type (mobile/landline), and carrier information. ### search_2fa Searches historical records for specific Two-Factor Authentication details. ### search_masking_interactions Finds records of interactions related to number masking activities. ### send_2fa Triggers the sending of a One-Time Password code to a user's phone number. ### send_bulk_sms Sends messages to multiple recipients simultaneously in one batch operation. ### send_sms Sends a single, specific text message to one recipient. ### set_2fa_limits Defines the operational rules and limits for how many times 2FA can be requested. ### set_2fa_workflows Configures multi-channel paths for 2FA delivery, such as routing a code from SMS to Voice. ### track_sms_conversion Measures the success rate of your SMS messages in achieving a desired outcome or click. ### update_masking_application Modifies existing number masking parameters without deleting them. ### update_masking_context Changes the rules or scope of an already established communication context. ### verify_2fa Confirms a user's identity by submitting and validating a received One-Time Password code. ## Prompt Examples **Prompt:** ``` Send an SMS to +1234567890 saying 'Your order is ready for pickup!' from 'MyStore'. ``` **Response:** ``` I've sent the SMS to +1234567890. The message ID is `msg_987654`. You can track its delivery status using this ID. ``` **Prompt:** ``` Send a 2FA verification code to +447700900123. ``` **Response:** ``` The 2FA code has been sent to +447700900123. Please provide the code once the user receives it, along with the Request ID: `req_abc123`. ``` **Prompt:** ``` Lookup the phone number +4915123456789 to see the carrier info. ``` **Response:** ``` I've looked up the number. It is a mobile number in Germany, currently served by 'Deutsche Telekom'. The number is valid and active. ``` ## Capabilities ### Global SMS Messaging Send single messages or manage large-scale, bulk message campaigns across various countries. ### Two-Factor Authentication Management Initiate the 2FA process by sending a verification code and completing the cycle by verifying the received OTP against an account. ### Number Validation and Lookup Check if a phone number is valid, determine its carrier, or mask numbers for privacy before use in communications. ### Usage Reporting Retrieve detailed metrics on SMS volume and 2FA attempts, grouped by country or date range. ## Use Cases ### Handling High-Volume Account Onboarding A developer needs to onboard 50 new users. Instead of writing a script that handles the request, wait time, and verification API calls separately, they prompt their agent: 'Run the full onboarding flow for these 50 numbers.' The agent uses `send_2fa` for every user and then waits for confirmation using `verify_2fa`, completing the entire process in one go. ### Running Geo-Targeted Marketing Campaigns A marketing manager needs to know if their latest campaign is working better in Germany versus France. They prompt the agent to run a report, which uses `get_sms_usage_by_country` to provide instant metrics showing where the highest engagement was. ### Securing Customer Data for Support A support team member needs to reset a customer's password. They tell their agent, 'Verify user John Doe.' The agent calls `send_2fa` and then prompts the agent to await confirmation, streamlining what was previously a three-step phone call process. ### Auditing Communication Security An audit team needs to prove that sensitive number data is correctly masked. They ask the agent to list all active masking tools using `list_masked_numbers` and check who has access with `list_masking_participants`, creating a complete security report. ## Benefits - Saves time by handling multi-step processes. Instead of manually sending a code, waiting for confirmation, and then logging the result, your agent can execute `send_2fa` followed by `verify_2fa` in one sequence. - Ensures deliverability before you spend credits. Before running any campaign, use `lookup_number` to validate recipient numbers, preventing messages from failing due to simple formatting errors. - Manages complex privacy requirements automatically. You can establish a secure communication boundary by using tools like `create_masking_context` and `add_masked_number`, ensuring customer data is protected at the source. - Handles high volume effortlessly. Running marketing campaigns that require sending thousands of messages is simple with `send_bulk_sms`, which keeps your workflow moving without manual batch uploads. - Provides clear accountability. You don't just send a message; you get analytics, like using `get_sms_usage_by_country` or `track_sms_conversion`, so you know exactly where and how well your messaging efforts are working. ## How It Works The bottom line is that your AI client acts as the orchestrator, managing the communication steps without you having to jump between a dashboard and an API call. 1. Subscribe to the Mitto MCP and enter your specific API key. 2. Instruct your AI client to perform a communication task—like sending an SMS or requesting a code—using natural language. 3. Your agent executes the necessary tool calls, manages the data flow (e.g., waiting for confirmation of the OTP), and provides the final status update. ## Frequently Asked Questions **How does Mitto MCP handle bulk messaging?** You use the `send_bulk_sms` tool. This function allows you to send messages to many recipients at once, streamlining your marketing efforts without manually sending each one. **Can I check if a phone number is valid using Mitto MCP?** Yes. The `lookup_number` tool validates the phone number's format and provides carrier information to ensure it's ready for communication. **What tools are available for Two-Factor Authentication with Mitto MCP?** You can use `send_2fa` to initiate the code, and then use `verify_2fa` once you have the user's response. You can also set rules using `set_2fa_limits`. **Is Mitto MCP useful for masking sensitive data?** Yes, it provides full control over masking through tools like `create_masking_context`, allowing you to group and manage numbers under a specific privacy application.