# Byteplant MCP

> Byteplant MCP is an MCP server for analytics and data. Validate email addresses, phone numbers and postal addresses with Byteplant's APIs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, API
- **Repository:** https://github.com/byteplant-devops/byteplant-mcp
- **MCP Registry name:** io.github.byteplant-devops/byteplant-mcp
- **Categories:** [analytics and data](https://ai-powered.com/categories/analytics-and-data), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/byteplant-mcp
