# NumVerify MCP > NumVerify validates phone numbers and audits their metadata using AI. It checks if a number is active, identifies its carrier (like AT&T or Vodafone), determines if it's a mobile or landline service, and pulls geographic location details instantly. Stop guessing on contact data; let your agent verify complex international numbers against real-time records. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** phone-validation, identity-verification, carrier-lookup, geolocation, data-audit, api-integration ## Description You know how messy contact lists get? You run into numbers that are dead, or you can't tell if a number belongs to a mobile phone or some old landline. NumVerify gives your agent the ability to audit global phone numbers and pull all the metadata needed to make sure your data is clean before you send out anything. When your agent runs `validate_phone`, it performs a full, comprehensive audit on any number you feed it. This isn't just checking if the digits are right; it confirms activity status and pulls core identifying data that’s essential for keeping your records accurate. You get immediate confirmation whether the number is genuinely valid and useful. If you need to know who owns the service, `get_phone_carrier` nails that down. It pulls specific carrier information, telling you exactly which company operates the line—whether it's AT&T, Vodafone, or some other local provider. Knowing the carrier helps you map out your entire network distribution and target campaigns precisely. The system also handles classifying the type of service with `get_phone_line_type`. This tool tells you if a number is mobile, whether it’s a traditional landline, or if it's VoIP—Voice over Internet Protocol. That classification is huge because it dictates what kind of communication channel you should use; you don't want to send an SMS to a landline, right? For geographic context, `get_phone_location` pulls the city and region tied directly to the area code. This means if your list has numbers from different parts of the world, you get instant location data for each one. It’s critical for making sure your outreach is targeted correctly. Putting it all together, your agent can run these tools sequentially: first, `validate_phone` gives a quick pass to confirm validity; then, if that passes, you hit `get_phone_carrier` to identify the provider, followed by `get_phone_line_type` to understand the service. You can then use `get_phone_location` for geographic context. This process lets your AI client treat complex international number validation like a simple conversation—it doesn't need you opening up separate databases or running any kind of manual spreadsheet macro. Whether you’re scrubbing massive lead lists or just confirming identity on a handful of numbers, NumVerify keeps your contact data reliable and actionable. ## Tools ### get_phone_line_type Checks if a number is mobile, landline, or VoIP by classifying its line type. ### get_phone_carrier Pulls carrier information for any given phone number, identifying the service provider. ### get_phone_location Retrieves the city and region associated with the phone number's area code. ### validate_phone Performs a comprehensive audit on a phone number to confirm if it is valid and retrieve core metadata. ## Prompt Examples **Prompt:** ``` Validate the phone number +14158586273 using NumVerify. ``` **Response:** ``` Phone number validated! The number is valid. It is a mobile line from San Francisco, United States, operated by AT&T. Would you like the full metadata? ``` **Prompt:** ``` Identify the carrier for +442071838750. ``` **Response:** ``` I've retrieved the carrier information. The number belongs to a landline in London, United Kingdom, and the carrier is identified. Would you like more location details? ``` **Prompt:** ``` Check if +5511999999999 is a mobile line. ``` **Response:** ``` I've checked the line type. Yes, +5511999999999 is identified as a mobile line in São Paulo, Brazil. I can also retrieve the carrier name if you'd like. ``` ## Capabilities ### Verify Number Validity Runs a full audit on any phone number, confirming if it's active and pulling essential metadata. ### Identify Carrier Information Finds out which company operates the number (the carrier), which is critical for targeting campaigns. ### Determine Line Type Classifies a phone number as mobile, landline, or VoIP to guide your communication strategy. ### Get Geographic Location Retrieves the city and region tied to the phone number's area code. ## Use Cases ### Cleaning a Cold Lead List You get a spreadsheet of 500 numbers. Instead of manually checking each one, your agent runs `validate_phone` on the entire list. The result is a clean JSON output showing which numbers are dead ends and which ones actually belong to mobile lines. ### Pre-Flight Campaign Check Marketing needs to send an SMS campaign only in London, UK. They feed the agent 100 numbers and ask it to run `get_phone_location`. The agent filters out everything outside the desired geography before the sends are triggered. ### Compliance Auditing The security team needs to audit all internal employee contacts. They use their AI client to prompt for a number and ask the agent to run `get_phone_carrier` and `get_phone_line_type`, confirming that every user's primary contact is a mobile line. ### Data Enrichment Pipeline A new CRM record comes in with just an international number. The agent automatically runs the full set of tools (`validate_phone`, `get_phone_carrier`, etc.) to enrich the single data point into a fully verified, geo-located contact profile. ## Benefits - Stop guessing if a lead is good. By running `validate_phone`, you get immediate confirmation of number validity before passing it to your workflow. - Target SMS campaigns better. Use `get_phone_line_type` to filter out numbers that aren't mobile, saving money and improving deliverability. - Map your clients precisely. If you need regional data, running `get_phone_location` gives you the city/region instantly—no guesswork needed. - Understand the network. Running `get_phone_carrier` lets you know if a number is from AT&T or Verizon, which matters for specific business logic. - Orchestrate full checks easily. Your agent can run all four tools sequentially: validate first, then check carrier, location, and type—all in one prompt. ## How It Works The bottom line is: you give it a number and context; it gives you a full report. 1. First, prompt your agent with a specific phone number. Your client runs `validate_phone` to confirm basic structural integrity. 2. Next, tell the agent what details you need (e.g., 'What's the carrier?' or 'Where is this located?'). It calls the relevant tool (`get_phone_carrier`, `get_phone_location`) with the validated number. 3. The system returns structured data detailing the carrier, location, and line type—all ready for your next action. ## Frequently Asked Questions **How do I use the validate_phone tool with an international number?** You simply pass the full, formatted international number (e.g., +14158586273) to `validate_phone`. The tool confirms its structure and pulls essential metadata like country codes. **Is get_phone_carrier only for US numbers?** No. You can run `get_phone_carrier` on any international number format, allowing you to identify the service provider anywhere in the world. **Can I use get_phone_line_type to differentiate between VoIP and mobile?** Yes. This tool classifies numbers as mobile, landline, or VoIP. It’s essential if you need to ensure your communication efforts go through the right channel. **Which tools do I use for complete data enrichment?** For maximum detail, run all four tools: `validate_phone` (for structure), followed by `get_phone_carrier`, `get_phone_line_type`, and finally `get_phone_location`. **What credentials do I need to use the validate_phone tool?** You'll need a NumVerify Access Key. After subscribing, you input this key into your AI client configuration. This allows your agent to authenticate against our endpoints and run the validation checks. **If I use get_phone_location with a number that has no public data, what does it return?** The tool returns a structured JSON object indicating 'No match found' or similar specific status codes. Your agent can read these failure signals to distinguish between an invalid format and genuinely unlisted numbers. **Are there rate limits when I use get_phone_carrier for bulk processing?** Yes, usage is governed by your subscription plan's defined quota. For high-volume data audits, queue requests through your agent’s workflow manager to manage throughput and avoid hitting hard API limits. **What specific format must the phone number be in for get_phone_line_type?** The number needs to follow E.164 international formatting (e.g., +CCXXXXXXXXX). Using this standardized structure ensures accurate parsing and reliable identification of the line type across all regions. **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.