Skip to content
MCP server

Byteplant MCP

Validate email addresses, phone numbers and postal addresses with Byteplant's APIs

Runs locallyStatus and history
Install
Platforms
CLI, API
Runs
Locally
Version
1.1.1
Listing updated
today

Similar MCP servers

About Byteplant MCP

Byteplant MCP is an MCP server for analytics and data. It runs locally on your machine and is started by your AI client.

Three tools, one per Byteplant validation service, each with its own API key supplied by environment variable. You only need keys for the services you use, and a tool with a missing key tells the assistant which variable to set instead of calling the API. Every tool also takes a timeout between 5 and 300 seconds.

Email checks return a numeric status, a category the server adds (valid, suspect, invalid or indeterminate), a description and whether the address is from a freemail provider. Phone checks return the status, line type such as mobile, fixed line or VoIP, location, national and international formats and carrier codes, with an express mode for static checks only. Address validation standardises postal addresses, supports an international code, can suggest corrections and optionally geocodes.

It runs locally over stdio through uvx or pip, or as a bundle for Claude Desktop. The README claims coverage in more than 240 countries.

Install

Run in a terminal

claude mcp add byteplant-mcp --env EV_TOKEN='<EV_TOKEN>' --env AV_TOKEN='<AV_TOKEN>' --env PV_TOKEN='<PV_TOKEN>' -- uvx byteplant-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "byteplant-mcp": {
      "command": "uvx",
      "args": [
        "byteplant-mcp"
      ],
      "env": {
        "EV_TOKEN": "<EV_TOKEN>",
        "AV_TOKEN": "<AV_TOKEN>",
        "PV_TOKEN": "<PV_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "byteplant-mcp": {
      "command": "uvx",
      "args": [
        "byteplant-mcp"
      ],
      "env": {
        "EV_TOKEN": "<EV_TOKEN>",
        "AV_TOKEN": "<AV_TOKEN>",
        "PV_TOKEN": "<PV_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "byteplant-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "byteplant-mcp"
      ],
      "env": {
        "EV_TOKEN": "<EV_TOKEN>",
        "AV_TOKEN": "<AV_TOKEN>",
        "PV_TOKEN": "<PV_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "byteplant-mcp": {
      "command": "uvx",
      "args": [
        "byteplant-mcp"
      ],
      "env": {
        "EV_TOKEN": "<EV_TOKEN>",
        "AV_TOKEN": "<AV_TOKEN>",
        "PV_TOKEN": "<PV_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "byteplant-mcp": {
      "command": "uvx",
      "args": [
        "byteplant-mcp"
      ],
      "env": {
        "EV_TOKEN": "<EV_TOKEN>",
        "AV_TOKEN": "<AV_TOKEN>",
        "PV_TOKEN": "<PV_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • EV_TOKENEmail Validator API Token
  • AV_TOKENAddress Validator API Token
  • PV_TOKENPhone Validator API Token

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

validate_email
Check deliverability and detect freemail providers
validate_phone
Validate a number and return line type, carrier and formats
validate_address
Validate and standardise a postal address with optional geocoding

What it does

Email deliverability
Reports status, category and whether the domain is a freemail provider.
Phone line details
Returns line type, location, formats and mobile carrier codes.
Address standardisation
Validates, corrects and optionally geocodes postal addresses.
Per-service keys
Separate tokens for email, phone and address; unused ones can be left blank.
Timeout control
Each call accepts a 5 to 300 second timeout.
Easy install
uvx, pip or a Claude Desktop bundle.

Good for

  • Check whether a signup email is deliverable
  • Tell mobile numbers from landlines before sending SMS
  • Clean and standardise a customer's shipping address
  • Geocode an address from a chat

Pricing

Pricing unknown

Server free to install; each Byteplant validation API requires its own key and plan

Byteplant MCP FAQ

What keys do I need?

EV_TOKEN for email, PV_TOKEN for phone and AV_TOKEN for address validation, from the matching Byteplant services.

What does a missing key do?

The tool tells the assistant which variable to set and does not call the API.

How does it run?

Locally over stdio with uvx or an installed command.

How do I add Byteplant MCP to Claude Code?

Run this command in your terminal: claude mcp add byteplant-mcp --env EV_TOKEN='<EV_TOKEN>' --env AV_TOKEN='<AV_TOKEN>' --env PV_TOKEN='<PV_TOKEN>' -- uvx byteplant-mcp

What are the best alternatives to Byteplant MCP?

The closest alternatives to Byteplant MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers