py-nameplate

A Python library, MCP server, and REST API for parsing unstructured US contact strings into structured components.

Nameplate takes messy contact data like “Dr. John Smith Jr. 742 Evergreen Terrace, Springfield, IL 62701” and extracts structured name components (prefix, first, middle, last, suffix) and address components (street, city, state, ZIP). It handles edge cases like “O’Brien” and “McDonald” capitalization, PO boxes, apartment units, and last-name-first formats. The library validates addresses against 29,880 US cities and can auto-fill missing city/state from 500,000+ street names.

curl -X POST https://nameplate.mcp.danheskett.com/api/parse \
  -H "Content-Type: application/json" \
  -d '{"text": "Dr. John Smith 123 Main St, Boston, MA 02101"}'

{
  "name": {"prefix": "Dr.", "first": "John", "last": "Smith"},
  "address": {"street_number": "123", "street_name": "Main", "street_type": "St", "city": "Boston", "state": "MA", "zip_code": "02101"}
}