# Smarty MCP for AI Agents AI Agent Connect > Smarty gives your AI agent the ability to handle messy address data like a pro. It validates, cleans, and completes both US and international street addresses instantly. Stop worrying about typos or missing zip codes; your agent can now verify deliverable locations and extract real addresses from unformatted text in seconds. It's built for production-grade location intelligence. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_WWrnyw2FpHy7mSqxHKiiqZHqicPR2sy1eg09Cn95/ai-agent-connect - **Tags:** address-validation, geocoding, data-sanitization, postal-verification, location-intelligence ## Description You're tired of your AI client guessing whether "123 Main St" actually exists or if it's a deliverable spot. This Connector handles the heavy lifting of location intelligence by connecting your agent directly to Smarty's production-grade data. Instead of copy-pasting addresses into a sandbox to see if they're valid, you can just tell your agent to check them. It cleans up messy user input, finds the correct zip codes for cities, and even pulls out physical locations hidden inside long emails or notes. It's a massive upgrade for anyone dealing with logistics or customer data because it replaces manual verification with instant, accurate results. You can find this among the thousands of tools in the Vinkius catalog, making it easy to plug into your existing workflow without building custom scripts. It takes the guesswork out of global shipping and local delivery by ensuring every address is normalized and verified before it hits your database. Whether you're trying to fix a broken shipping pipeline or just want to make sure your customers aren't entering fake addresses, this tool provides the ground truth you need. It bridges the gap between raw, messy text and clean, actionable geographic data, so your team can focus on moving products rather than fixing typos. ## Tools ### extract_addresses Pulls physical addresses out of unformatted text like emails or notes. This helps turn messy notes into clean data. ### validate_us_address Verifies US street addresses and returns delivery point validation status and coordinates. This confirms a spot is deliverable. ### verify_zip_code Checks a 5-digit zip code to return the associated city and state. It prevents errors caused by incorrect postal codes. ### autocomplete_intl_address Provides predictive suggestions for international street addresses based on partial input. It helps find global locations quickly. ### validate_intl_address Validates and geocodes international street addresses including the country. It ensures your global shipping data is accurate. ### autocomplete_us_address Predicts complete US street addresses to help users find the right location quickly. It speeds up data entry for domestic shipping. ### get_account_info Pulls your current Smarty account details and status. Use this to check your current subscription or API status. ## Prompt Examples **Prompt:** ``` Can you check if 100 Main St, New York, NY 10001 is a real place? ``` **Response:** ``` I've checked that address with the Smarty data. Here is the validation result: **Normalized Address**: 100 Main St, New York, NY 10001-1234 **Deliverable**: Yes **County**: New York **Coordinates**: Lat 40.71, Long -74.00 ``` **Prompt:** ``` I have this email: 'Please send the package to 456 Oak Ave, Seattle'. Can you find the address? ``` **Response:** ``` I found the following address in that email: **Address**: 456 Oak Ave, Seattle, WA 98101 **Status**: Verified deliverable location. Would you like me to normalize this for your shipping list? ``` **Prompt:** ``` What are the top 3 suggestions for '3311 w 300 s'? ``` **Response:** ``` Based on the partial input `3311 w 300 s`, here are the most likely locations: 1. **3311 W 300 S**, Salt Lake City, UT 84104 2. **3311 W 300 S**, Syracuse, IN 46567 3. **3311 W 300 S**, Swayzee, IN 46986 ``` ## Capabilities ### Clean up messy user-submitted addresses The agent takes raw, unformatted text and turns it into standardized, verified locations. ### Pull physical locations out of long paragraphs or emails Your agent can scan through long strings of text to find and isolate real street addresses. ### Predict full addresses from partial street names The AI provides accurate completions for US and international addresses based on just a few words. ### Check if a zip code is valid and see which city it belongs to Instant verification of 5-digit postal zones returns the correct city and state data. ### Verify if a specific delivery point is actually reachable Get delivery point validation to ensure a specific apartment or suite is actually reachable. ### Get your account details and status quickly Retrieve your current account information and status directly through your agent. ## Use Cases ### Fixing "Dirty" Customer Data A data engineer feeds a list of raw customer notes to the agent and uses `extract_addresses` to build a clean shipping list. ### Shipping Form Validation An e-commerce dev uses `validate_us_address` to check if a customer's input is a real, deliverable spot during checkout. ### Global Logistics Planning A logistics lead asks the agent to find the city and state for a list of 500 zip codes using `verify_zip_code`. ### Smart Search Bars A dev uses `autocomplete_intl_address` to build a search bar that suggests real locations as the user types. ## Benefits - Clean up your database by using `validate_us_address` to catch typos and missing units before they cause shipping delays. - Save time on data entry by letting your agent use `autocomplete_us_address` to suggest full locations from partial text. - Stop manual searching with `verify_zip_code` which instantly returns city and state info for any postal zone. - Handle messy inputs automatically with `extract_addresses` to pull locations out of long, unformatted notes. - Get precise geocoding for global shipping by using `validate_intl_address` to normalize international street data. ## How It Works The bottom line is you get production-grade address verification without writing a single line of integration code. 1. Sign up for Smarty and grab your Auth ID and Token. 2. Add those credentials to your Connector configuration. 3. Ask your agent to validate, extract, or autocomplete addresses in any chat or IDE. ## Frequently Asked Questions **Can Smarty MCP handle international addresses?** Yes, it handles both US and international street addresses. You can validate global locations to ensure your shipping data is accurate across different countries. **How does Smarty help with messy customer data?** It identifies physical addresses buried in raw text like emails or notes. This helps you turn unorganized notes into a clean, usable list of locations. **Can I use Smarty to find zip codes?** It can verify a 5-digit zip code and return the associated city and state. This is great for checking postal zones during data entry or cleanup. **Does Smarty validate apartment numbers?** It validates delivery point status, which includes checking for specific units and apartment details. This ensures your packages actually reach the front door. **How do I connect Smarty to my AI agent?** You just need to add your Smarty Auth ID and Token to the Connector configuration. Once connected, your AI client can query the location data directly. **Can it extract addresses from long paragraphs?** It can pull locations out of long paragraphs of text. This is perfect for cleaning up old customer records or extracting addresses from support tickets. **Can the AI find an address hidden inside a block of text automatically?** Yes! You can paste an entire email string or customer support note into your prompt and ask the AI: 'Extract any addresses mentioned in this text.' The agent triggers the `extract_addresses` engine to return the geolocated and sanitized address format purely. **How accurate is the address verification?** Smarty ensures the address is validated against official sources like the USPS using DPV (Delivery Point Validation) for US requests, guaranteeing a package can actually be delivered to the mapped coordinate. Your AI agent returns this rigorous underlying metadata. **Can I use the agent to fix my dataset dynamically without coding?** Yes. If you have 20 poorly formatted customer addresses, you can simply paste them in the prompt, asking your AI to 'Run each of these through Smarty and return a markdown table of the normalized addresses.' The agent handles the iteration loop for you via the tools.