home / mcp / byteplant validator mcp server

Byteplant Validator MCP Server

Provides real-time validation of emails, phones, and addresses via Byteplant validators within MCP clients.

Installation

Add the following to your MCP client configuration file.

Configuration

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

You can deploy the Byteplant Validator MCP Server to perform real-time validation of email addresses, phone numbers, and postal addresses within any MCP-compatible client. This server uses Byteplant’s validated APIs to deliver live checks directly in your data capture flows, helping you ensure accuracy and reduce invalid inputs in your applications.

How to use

Install and run the MCP server locally, then connect your MCP client to it so you can validate user inputs in real time. You will provide API tokens for the Email Validator, Phone Validator, and Address Validator services, and configure your MCP client to start the Byteplant MCP server as a local process.

How to install

Prerequisites you need before installing the MCP server:

Python 3.12 or newer

API keys for Email Validator, Phone Validator, and Address Validator

Claude Desktop or any MCP client that supports the MCP protocol

Next, install the Byteplant MCP package locally using Python’s package manager.

pip install byteplant-mcp

Additional configuration and usage details

To run the MCP server locally and integrate it with your MCP client, start the server as shown in the configuration snippet. The server runs as a local process and communicates with your MCP client via the configured MCP interface.

{
  "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>"
      }
    }
  }
}

Security and tokens

Keep your API tokens secret. Use separate tokens for each validator if you enable multiple validation services and limit their scope to reduce risk.

Notes and troubleshooting

If you encounter rate limits or API key issues, verify that your tokens are valid and that you are within the allowed usage quotas for each service.

Available tools

validate_email

Performs real-time email deliverability validation and returns detailed status information.

validate_phone

Performs real-time phone number validation, including line type, carrier, and location details.

validate_address

Performs real-time address validation and returns deliverability status along with standardized address details.