# NumVerify MCP for AI Agents AI Agent Connect > NumVerify lets your AI agent validate phone numbers and pull carrier, location, and line-type data instantly. It turns manual lookups into automated checks for cleaning lead lists or verifying user identities across global markets. ## Overview - **Category:** communication-messaging - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_qJUzd0bUEJU7XQ6Mvmtl5EisPV9shJJWOFH8UTtG/ai-agent-connect - **Tags:** phone-validation, identity-verification, carrier-lookup, geolocation, data-audit, api-integration ## Description Imagine you're managing a massive list of international leads. Usually, you'd have to manually check if a number is actually reachable, what country it's from, or if it's a landline or a mobile phone. It's a slog of copy-pasting and clicking through different websites. With NumVerify, your AI agent handles the heavy lifting. You can just ask your agent to audit a list of contacts, and it'll tell you exactly who's on a mobile line in London versus a VoIP number in New York. It pulls in carrier names and geographic data so you can see where your audience actually lives. It's one of the many ways you can expand what your agent can do through the Vinkius catalog, making sure your communication strategy is based on real data rather than guesswork. Instead of digging through spreadsheets, you get a clear picture of your reach. ## Tools ### get_phone_location Pull the city and region for a phone number. Use this to understand your audience's geographic reach. ### validate_phone Check if a phone number is valid and get its basic metadata. This is your first step for cleaning any contact list. ### get_phone_line_type Determine if a number is a mobile, landline, or other type. This helps you decide if a number is even suitable for your outreach. ### get_phone_carrier Get the network provider for a specific phone number. It helps you see which carriers your users are on. ## Prompt Examples **Prompt:** ``` Check if +12025550123 is a mobile number and tell me where it's from. ``` **Response:** ``` I've checked that number for you. It's a valid mobile line located in Washington, D.C. It's currently serviced by Verizon. Would you like me to check more numbers from your list? ``` **Prompt:** ``` I have a list of 5 numbers. Tell me the carrier for each one. ``` **Response:** ``` Here is the carrier information for your list: | Phone Number | Carrier | Type | | :--- | :--- | :--- | | +14155550101 | AT&T | Mobile | | +12125550102 | T-Mobile | Mobile | | +13105550103 | Verizon | Mobile | | +16175550104 | Sprint | Mobile | | +12025550105 | AT&T | Mobile | ``` **Prompt:** ``` Is +442071838750 a landline or a mobile? ``` **Response:** ``` That number is identified as a landline in London, United Kingdom. Since it's a landline, it's likely not suitable for SMS campaigns. ``` ## Capabilities ### Validate international numbers Check if a phone number is active and get its country and dial codes. ### Identify mobile vs. landline Distinguish between different line types to target the right communication channel. ### Pull carrier names See which network a user is on to understand their service provider. ### Find geographic locations Get the city and region associated with a phone number instantly. ### Audit lead lists Clean up contact data by identifying and removing invalid numbers. ## Use Cases ### Lead List Scrubbing A sales lead has a messy list of 5,000 numbers. They ask their agent to use validate_phone to remove any invalid entries and keep only the active ones. ### SMS Campaign Optimization A marketing manager wants to avoid sending texts to landlines. They ask their agent to use get_phone_line_type on their list to filter out everything but mobile numbers. ### Fraud Prevention A security team needs to flag high-risk sign-ups. They ask their agent to use validate_phone and get_phone_line_type to see if a user is using a VoIP number. ### Geographic Mapping A local business wants to see where their customers are from. They ask their agent to use get_phone_location to group their current contacts by city and region. ## Benefits - Stop wasting money on dead leads by using validate_phone to scrub your lists before you start your campaigns. - Know exactly where your customers are located by using get_phone_location to map out your geographic reach. - Avoid sending SMS to landlines by checking the line type with get_phone_line_type before you hit send. - Understand your network distribution by using get_phone_carrier to see which providers your audience uses most. - Maintain clean data integrity by automatically retrieving official country names and formatting details for every contact. ## How It Works The bottom line is your AI agent becomes a real-time communications analyst that handles all the phone metadata for you. 1. Subscribe to the NumVerify MCP. 2. Add your NumVerify Access Key to your agent's configuration. 3. Ask your agent to verify numbers or pull carrier data. ## Frequently Asked Questions **Can NumVerify check international numbers?** Yes, it supports global phone numbers, providing you with the country, dial code, and geographic location for each one. **How does NumVerify help with SMS marketing?** It identifies the line type so you can filter out landlines and VoIP numbers, ensuring your messages only go to actual mobile devices. **Can I use NumVerify to find out which carrier a user has?** Yes, the tool retrieves the current carrier for a phone number, which helps you understand your network distribution. **Does NumVerify give me the city of a phone number?** It provides geographic location details, including the city and region associated with the number. **How do I use NumVerify to clean my lead list?** You can ask your agent to run a validation check on your entire list to identify and remove invalid numbers automatically. **Can I use NumVerify to identify fraud?** It helps by identifying VoIP numbers and checking the validity of numbers during sign-up, which are common indicators of bot activity. **How do I find my NumVerify Access Key?** Log in to your [**NumVerify dashboard**](https://numverify.com/dashboard), and you will find your Access Key on the main page. Copy and paste it below. **Does it support international numbers?** Yes. NumVerify covers over 232 countries and provides detailed validation and metadata for global phone numbers. **Can the agent identify if a number is mobile or landline?** Yes. The `get_phone_line_type` tool retrieves the line type (e.g., 'mobile', 'landline') allowing you to audit the nature of your contact data.