Byteplant Validator MCP Server

Email, Phone Number, and Address Validation for the Model Context Protocol (MCP)

This package provides an MCP server that uses Byteplant’s Email-Validator, Phone-Validator, and Address-Validator APIs to deliver real-time live validation in any MCP-compatible client.

Features

• Email validation
• Phone number validation
• Postal address validation
• Fast studio MCP server
• Local execution
• Easy integration with Claude Desktop

Requirements

• Python ≥ 3.12
• A Byteplant API key (one for each validator). You can register to get one here
• MCP Client (e.g. Claude Desktop)

MCP Configuration (Claude Desktop)

1. Installation

First, install the python module. You can use local installation (like venv) or global.

pip install byteplant-mcp

2. Configuration

Next, add the MCP server to Claude configuration.

{
	"mcpServers": {
		"byteplant": {
			"command": "path/to/python/installation",
			"args": ["-m", "byteplant-mcp"],
			"env": {
				"EV_TOKEN": "<EMAIL VALIDATOR API TOKEN>",
				"PV_TOKEN": "<PHONE VALIDATOR API TOKEN>",
				"AV_TOKEN": "<ADDRESS VALIDATOR API TOKEN>"
			}
		}
	}
}	

Byteplant's Email, Phone, and Address Validation Tools

1. validate_email

Real-Time Email Validation API

The Email Validation API returns the deliverability status and detailed information for the email that is provided as input.

API Endpoint

Example API Request (GET)

https://api.email-validator.net/api/verify?EmailAddress=support@byteplant.com&APIKey=your API key

Input Parameters

API Result (JSON)

2. validate_phone

Real-Time Phone Validation API

The Real-Time Phone Verification API validates a single phone number in real-time.
It returns the status (VALID_CONFIRMED, VALID_UNCONFIRMED, INVALID) as well as details such as line type, carrier/operator, and location.

API Endpoint

Example API Request (GET)

https://api.phone-validator.net/api/v2/verify?PhoneNumber=09874-322466&CountryCode=de&APIKey=your API key

Input Parameters

API Result (JSON)

3 validate_address

Real-Time Address Validation API

The Address Validation API returns the deliverability status and detailed information for the address that is provided as input.

API Endpoint

Example API Request (GET)

https://api.address-validator.net/api/verify?StreetAddress=Heilsbronner Str. 4&City=Neuendettelsau&PostalCode=91564&CountryCode=de&Geocoding=true&APIKey=your API key

Input Parameters

General Usage Notes

Always use commas (",") to separate address elements where needed.

StreetAddress may contain the complete address; optional fields may be left empty.

China / Japan / Korea

Native script: Use big → small order for all fields.

English script: Use small → big order for all fields.

API Result (JSON)

Environment Variables

• EV_TOKEN: Your Email Validator API Token
• PV_TOKEN: Your Phone Validator API Token
• AV_TOKEN: Your Address Validator API Token You may use only the tokens for the services you use (e.g. only Email Validator), in that case leave the others tokens empty.

Contact

• Website: https://www.byteplant.com

• Get your API key: https://www.byteplant.com/account/

• Email: contact@byteplant.com