Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add mcp -e NUMRADAR_KEY=<NUMRADAR_KEY> -- npx -y @numradar/mcp
Open on GitHub

What 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_numbers for this E.164 number list and summarise which entries are reachable on WhatsApp.
  • Use /clean_contact_list on this contact list before the campaign and report the records that need fixing.
  • Run /check_before_spending with count set 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/mcp

Replace <…> with your own values

2Platform CLI: remote server

claude mcp add --transport http numradar https://numradar.app/mcp

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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →
Postio — UK Address, Postcode, Email & Phone Validation postio-uk Postio — UK Address, Postcode, Email & Phone Validation is a Claude Code MCP server for UK address, PAF postcode, email, and phone validation in checkout and contact verification. CX Codex +1 twilio-lookup-phone-intelligence official Twilio twilio-lookup-phone-intelligence — a skill for Codex and ChatGPT that validates phone numbers via Twilio Lookup v2 API. Detects line type (mobile, landline, VoIP), SIM swap, caller name, and SMS pumping risk. CX Codex GP ChatGPT +1 ★ 8,052repo stars AirysChat MCP Server AirysChat This MCP server connects Claude Code to AirysChat. An agent can work with conversations, CRM, AI agents, and WhatsApp campaigns through it. CX Codex +1 ManyContacts.com MCP for WhatsApp Business manycontacts The ManyContacts.com MCP for WhatsApp Business MCP server connects an AI agent to ManyContacts CRM to manage WhatsApp Business contacts, conversations, and campaigns. Use it to handle CRM work from Claude Code. CX Codex +1 251installs whatsapp-automation claude-office-skills whatsapp-automation is a Claude Code skill for WhatsApp Business messaging, including customer support, notifications, and chatbot flows. It covers setup for automated replies and order updates. CX Codex +1 6,700installs aws-social-messaging aws The aws-social-messaging skill manages WhatsApp messaging through AWS End User Messaging Social, including templates, media, delivery events, and troubleshooting. Use it when building messaging flows. CX Codex +1 3,800installs

Project sponsors

Companies that keep this analytics open