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

Parameter	Value
API URL	https://api.email-validator.net/api/verify
Method	GET or POST

Example API Request (GET)

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

---

Input Parameters

Parameter	Description
EmailAddress	Email address to validate (string).
APIKey	Your API key (string).
Timeout	Timeout in seconds (int). Default: 10 (min 5, max 300).

---

API Result (JSON)

Parameter	Description
status	API result code. 401, 118, 119 indicate API errors: • 401 → Email address missing • 118 → Rate Limit Exceeded • 119 → API Key Invalid or Depleted
info	Short status description.
details	Full status description.
freemail	Indicates if email is from a freemail provider (true / false).
ratelimit_remain	Remaining API requests before rate limit is reached (default: 100 requests / 300s).
ratelimit_seconds	Seconds remaining in the current rate-limit interval.

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

Parameter	Value
API URL	https://api.phone-validator.net/api/v2/verify
Method	GET or POST

Example API Request (GET)

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

---

Input Parameters

Parameter	Description
PhoneNumber	Phone number to validate (string, URL encoded). Accepts national format or international format with leading + (+ → %2B, space → %20).
CountryCode	Two-letter ISO 3166-1 country code (string). Optional if number is in international format.
Locale	IETF language tag for geocoding (string). Optional; default: en-US.
Mode	Validation mode (string): express (static checks) or extensive (full validation). Optional; default: `

... View full README on GitHub