NumRadar — Claude Code MCP server: WhatsApp checks
NumRadar is an MCP server for Claude Code that checks WhatsApp registration and returns line type, country, and business status. It supports contact and list audits.
MIT updated 2026-08-12
claude mcp add mcp -e NUMRADAR_KEY=<NUMRADAR_KEY> -- npx -y @numradar/mcpWhat NumRadar does
NumRadar gives an AI agent tools for checking WhatsApp numbers. validate_number handles a single number, while bulk_validate creates a job for up to 10,000 numbers. The server also exposes job progress, recent jobs, and the remaining credit balance.
Numbers should use E.164 notation, such as +14155550100. A definitive result costs 1 credit; invalid or unparseable numbers do not consume credits. For a list, bulk_validate is the better fit because the agent can poll one job instead of sending repeated individual checks.
You can connect to the hosted MCP endpoint or run the npm package through npx. The local process needs NUMRADAR_KEY; placing a bearer key in a shell command or config file can expose it through command history or stored configuration.
What it helps with
- check whether one number uses WhatsApp
- validate a list of up to 10,000 numbers
- identify business accounts in a contact list
- check the credit balance before a run
- track a bulk validation job
Example prompts for the agent
- Run
/check_numbersfor this E.164 number list and summarise which entries are reachable on WhatsApp. - Use
/clean_contact_liston this contact list before the campaign and report the records that need fixing. - Run
/check_before_spendingwithcountset to the planned number of checks and verify the available balance.
How to install NumRadar
1Platform CLI
claude mcp add mcp -e NUMRADAR_KEY=<NUMRADAR_KEY> -- npx -y @numradar/mcpReplace <…> with your own values
2Platform CLI: remote server
claude mcp add --transport http numradar https://numradar.app/mcp1Platform CLI: remote server
codex mcp add numradar --url https://numradar.app/mcp2Platform CLI
codex mcp add numradar --env NUMRADAR_KEY=<NUMRADAR_KEY> -- npx -y @numradar/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"numradar": {
"url": "https://numradar.app/mcp"
}
}
}{
"mcpServers": {
"numradar": {
"command": "npx",
"args": [
"-y",
"@numradar/mcp"
],
"env": {
"NUMRADAR_KEY": "<NUMRADAR_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"numradar": {
"type": "http",
"url": "https://numradar.app/mcp"
}
}
}{
"servers": {
"numradar": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@numradar/mcp"
],
"env": {
"NUMRADAR_KEY": "<NUMRADAR_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http numradar https://numradar.app/mcp2Platform CLI
gemini mcp add -e NUMRADAR_KEY=<NUMRADAR_KEY> numradar npx -y @numradar/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about NumRadar
How do I install NumRadar in Claude Code?
Run claude mcp add --env NUMRADAR_KEY=<NUMRADAR_KEY> --transport stdio numradar -- npx -y @numradar/mcp. This adds the server through the npm package.
What does NumRadar do?
It checks whether a phone number is registered on WhatsApp and can return its country, line type, and business-account status. Bulk jobs are available for larger lists.
How many numbers can one bulk check handle?
bulk_validate accepts up to 10,000 numbers. Each definitive result costs 1 credit, while checking job progress is free.