# Postal Address Normalizer AI Agent Connect

> Standardizes and validates unstructured postal addresses for US, UK, CA, and AU.

## Overview
- **Category:** utilities
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_KAzhtgj3uEJ9deKPUyGEhm7R75wSiDISDvtYbI2g/ai-agent-connect
- **Tags:** address, normalization, validation, postal, data-cleaning

## Description

This MCP server provides high-precision tools to transform messy, human-written address strings into structured, machine-readable data. It handles country-specific abbreviation mapping (e.g., 'Street' to 'ST') and performs strict regex-based validation for postal codes in the US, UK, Canada, and Australia. Use `normalize_address` to decompose raw strings, `validate_postal_code` to verify regional formats, and `evaluate_address_completeness` to calculate a deliverability score based on mandatory field presence.

## Tools

### evaluate_address_completeness
Determines if an address contains all the necessary components for successful delivery in a specific region

### normalize_address
Converts a raw, unstructured address string into a structured and standardized format

### validate_postal_code
Checks if a specific postal code string is structurally valid for a given country

## Prompt Examples

**Prompt:** 
```
Normalize this address for the US: 123 Main Street, Springfield, IL 62704
```

**Response:** 
```
{
  "recipient": null,
  "streetNumber": "123",
  "streetName": "Main",
  "directional": null,
  "suffix": "ST",
  "unit": null,
  "city": "Springfield",
  "stateProvince": "IL",
  "postalCode": "62704",
  "deliverabilityScore": 100
}
```

**Prompt:** 
```
Is the postal code M5V 2T6 valid for Canada?
```

**Response:** 
```
{
  "isValid": true,
  "countryFormatMatch": true,
  "confidenceScore": 1.0
}
```

**Prompt:** 
```
Check if this address is complete for Australia: 45 George St, Sydney
```

**Response:** 
```
{
  "isComplete": false,
  "missingFields": ["postalCode"],
  "completenessScore": 75
}
```

## Frequently Asked Questions

**Which countries are supported?**
The server currently supports the United States (US), United Kingdom (UK), Canada (CA), and Australia (AU).

**How is the deliverability score calculated?**
The score is derived from the completeness of mandatory components and how strictly the postal code adheres to the expected regional pattern.

**Can I use this to standardize street suffixes?**
Yes, the `normalize_address` tool automatically applies country-specific abbreviation dictionaries to standardize suffixes like 'Avenue' to 'AVE'.