Byteplant Validator MCP Server

Validate and standardize a postal address and return its status, standardized address components, and optionally its coordinates.

Result fields:

• status (string): VALID: address is correct and deliverable. SUSPECT: address is incorrect and needs corrections to be deliverable, a suggested correction is provided. INVALID: address is incorrect and not deliverable - either there is no match at all in the reference data or the address is ambiguous and there are a lot of different matches. In these cases automatic correction suggestions are not available. DELAYED, NO_COUNTRY, RATE_LIMIT_EXCEEDED, API_KEY_INVALID_OR_DEPLETED, RESTRICTED, INTERNAL_ERROR

• formattedaddress (string): full address in standardized format

• supplement (string): additional address details (building / unit / apt / suite etc.)

• street (string): street address in standardized format

• streetnumber (string): street number in standardized format

• postalcode (string): zip / postal code in standardized format

• city (string): city in standardized format

• type (string): address type: S = Street address | P = P.O. Box, Pick-Up or other delivery service

• rdi (string): Residential Delivery Indicator (Commercial / Residential)

• district (string): district in standardized format

• county (string): county in standardized format

• state (string): state / province in standardized format

• country (string): two-letter ISO 3166-1 country code

• latitude (number): latitude (for valid addresses if Geocoding is enabled)

• longitude (number): longitude (for valid addresses if Geocoding is enabled)

• diagnostics (string): detailed diagnostic hints, indicating errors in the address input

• corrections (string): detailed correction hints, indicating which parts of the address input have been fixed

• ratelimit_remain (int): number of API requests remaining before the API rate limit is reached (the default API rate limit allows 100 API requests in 300s)

• ratelimit_seconds (int): number of seconds remaining in the current rate limit interval

Validate an email address and return info about it.

Result fields:

• status (int): API result code. 401, 118 and 119 status codes indicate API errors: 401 -> info: 'Email address missing' 118 -> info: 'Rate Limit Exceeded' 119 -> info: 'API Key Invalid or Depleted'

• info (string): short status description

• details (string): full status description

• freemail (boolean): indicates freemail addresses (Gmail, Yahoo, Outlook/Hotmail/Live, AOL, ...) [true | false]

• ratelimit_remain (int): number of API requests remaining before the API rate limit is reached (the default API rate limit allows 100 API requests in 300s)

• ratelimit_seconds (int): number of seconds remaining in the current rate limit interval

• category, status_description: added from the numeric status code (category is VALID, SUSPECT, INVALID, INDETERMINATE or UNKNOWN)

Validate a phone number and return its status, line type, carrier codes, location and national/international formats.

Result fields:

• status (string): VALID_CONFIRMED, VALID_UNCONFIRMED, INVALID, DELAYED, RATE_LIMIT_EXCEEDED, API_KEY_INVALID_OR_DEPLETED

• linetype (string): FIXED_LINE, MOBILE, VOIP, TOLL_FREE, PREMIUM_RATE, SHARED_COST, PERSONAL_NUMBER, PAGER, UAN, VOICEMAIL

• location (string): geographical location (city, county, state)

• countrycode (string): two letter ISO 3166-1 country code

• formatnational (string): phone number in national format

• formatinternational (string): phone number in international format

• mcc (string): mobile country code to identify a mobile network operator (carrier) using the GSM (including GSM-R), UMTS, and LTE networks

• mnc (string): mobile network code to identify a mobile network operator (carrier) using the GSM (including GSM-R), UMTS, and LTE networks

• ratelimit_remain (int): number of API requests remaining before the API rate limit is reached (the default API rate limit allows 100 API requests in 300s)

• ratelimit_seconds (int): number of seconds remaining in the current rate limit interval