home / mcp / whatsapp number validators mcp server

Whatsapp Number Validators MCP Server

Provides access to Whatsapp Number Validators API with number and phone validation endpoints using a stdio-based MCP runtime.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "bach-ai-tools-bachai-whatsapp-number-validators": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

This MCP server provides access to the Whatsapp Number Validators API via a streamlined, zero-config MCP client. It lets you validate WhatsApp registration and business status for numbers, with secure API-key-based authentication and multiple convenient run modes for local development and production workflows.

How to use

You will run this MCP server as a stdio-based MCP, which connects to a local process and communicates through standard input and output. You authenticate with an API key, supply the key to the server, and then send requests from your MCP client to the exposed endpoints.

How to install

Prerequisites you need installed on your machine before running this MCP: Python 3.x and pip, or the uvx runtime for quick startup.

Option A configure with uvx (quick start) — this runs without installing uvx manually.

uvx --from bach-whatsapp_number_validators bach_whatsapp_number_validators

Option B run in development mode with Python (directly from source): start the server with Python.

python server.py

Option C install the package and run the installed command after installation.

pip install bach-whatsapp_number_validators
bach_whatsapp_number_validators

Additional sections

Configuration is done via environment variables. Set your API key in the environment to enable authentication for all requests.

Environment variables

export API_KEY="your_api_key_here"

In MCP configuration files or tooling, expose the API key to the running server. The following examples demonstrate how to wire the server into two common MCP clients.

{
  "mcpServers": {
    "wa_valid": {
      "command": "uvx",
      "args": ["--from", "wa_valid", "wa_valid"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

Available tools

ping

Ping Validation Test endpoint at GET /ping

check_if_number_is_business_via_post_request

POST /v1/wa_id/business to verify if a number is on WhatsApp and whether it is a WhatsApp Business number

check_if_number_is_business_via_get_request

GET /v1/wa_id/business to verify if a number is on WhatsApp and whether it is a WhatsApp Business number (requires number and country code)

bulk_validation

POST /v1/bulk_validate/wa_id to validate up to 25 numbers in a single call and determine their WhatsApp Business status

validate_single_number_via_post_request

POST /v1/validate/wa_id to validate a single number for WhatsApp registration and business status

validate_single_number_via_get_request

GET /v1/validate/wa_id to validate a single number for WhatsApp registration and business status (requires number and country code)

phone_number_validation_via_post_request

POST /v1/validate/phone to validate a phone number and obtain alternative valid numbers for different countries if needed

phone_number_validation_via_get_request

GET /v1/validate/phone to validate a phone number and obtain alternative valid numbers for different countries if needed