bulk-whatsapp-number-checker
BWAV - Bulk WhatsApp Number Checker with MCP. Privacy-first Chrome extension to validate single and bulk WhatsApp numbers, with an optional MCP bridge for AI agents.
Install / Use
claude mcp add DuckB1t -- npx -y github:DuckB1t/bulk-whatsapp-number-checkerIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of bulk-whatsapp-number-checker
bulk-whatsapp-number-checker scores 75/100 on our quality scale, 3764th of 4,705 Development & Engineering skills we index.
Its MCP Server is 5.2 KB long, well organised into 17 sections with 1 code example: a solid amount of guidance for an agent.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 43 days ago, so bulk-whatsapp-number-checker is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-12. Automated pattern scan on 2026-11-12. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
bulk-whatsapp-number-checker compared with similar skills
All 4 of these similar skills score higher than bulk-whatsapp-number-checker; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| bulk-whatsapp-number-checker (this skill)by DuckB1t | 75 | 3 | 43d ago | MCP Server |
| taste-skillby Leonxlnx | 100 | 120.0k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 114.0k | today | CLAUDE.md |
| hyperframesby heygen-com | 100 | 88.2k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.3k | today | CLAUDE.md |
Frequently asked questions
- How do I install bulk-whatsapp-number-checker?
- Run
claude mcp add DuckB1t -- npx -y github:DuckB1t/bulk-whatsapp-number-checker. The install tabs above show the steps for each supported agent. - Which AI agents does bulk-whatsapp-number-checker work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is bulk-whatsapp-number-checker safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is bulk-whatsapp-number-checker still maintained?
- The repository was last updated 43 days ago, so bulk-whatsapp-number-checker is actively maintained.
Skill content
View source on GitHubBWAV - Bulk WhatsApp Number Checker with MCP
Check if phone numbers are registered on WhatsApp. Fast, local, zero drama.
BWAV is a Chrome extension that tells you whether a phone number is on WhatsApp, one at a time or by the hundreds. It drives your own WhatsApp Web tab and reads the screen, the same way you would. No third-party APIs, no servers, no sneaky data collection.

What it does
- Single and bulk checks. Paste one number or a thousand.
- Privacy-first. Everything runs in your browser. Numbers only ever go to WhatsApp Web inside your own logged-in session.
- Zero dependencies. Pure vanilla JavaScript. No build step, no
node_modules, no 47 transitive packages that each depend on 300 more. - Smart import. Paste from Excel/CSV, messy or clean. The parser normalizes country codes for you.
- Export. HTML or CSV reports of who's registered and who isn't.
- Dark mode. Because your eyes matter.
- AI-agent ready. Optional MCP bridge so AI agents (Claude, opencode, Cursor) can run checks through the same extension.
How it works
- You give it a number (or a list).
- It opens (or reuses) a WhatsApp Web tab and navigates to the number's chat URL.
- A content script inspects the page: chat input means REGISTERED, "invalid number" dialog means NOT_REGISTERED, QR/login screen means NOT_LOGGED_IN, timeout means UNKNOWN.
- Results land in the popup, ready to export.
No WhatsApp Business API. No paid gateways. Just your browser doing what it can already do.
Install
Chrome Web Store (recommended)
Install from the Chrome Web Store
Unpacked (for development)
- Download or clone this repo.
- Open
chrome://extensions. - Flip on Developer mode (top-right corner).
- Click Load unpacked and select the project folder.
- Open the popup, make sure you're logged into WhatsApp Web in a tab, and go.
Usage
Single check
Type a number (local or international, e.g. 01712345678 or +8801712345678), pick the country, hit check.
Bulk check
Paste a list, one per line or comma/space separated. The parser handles +, spaces, dashes, and country codes. Then hit Start.
Statuses
| Status | Meaning |
|---|---|
| REGISTERED | WhatsApp Web loaded the chat |
| NOT_REGISTERED | WhatsApp says the number is invalid / not registered |
| UNKNOWN | Timed out or couldn't tell |
| INVALID | The number format is garbage |
Settings
| Setting | Default | What it does |
|---|---|---|
| Default country | BD | Used for numbers without a country code |
| Check timeout | 20s | How long to wait per number |
| Inter-check delay | 1.5s | Pacing between bulk checks |
| Theme | auto | Light / dark / system |
| AI Agent (MCP) | off | Local bridge for AI agents |
AI Agent (MCP) bridge
BWAV ships a zero-dependency MCP server (mcp/server.js) so AI agents can check numbers through your real, logged-in WhatsApp Web session. Enable it in Settings > AI Agent (MCP), copy the generated config into your agent, and you get tools like check_whatsapp_number and check_whatsapp_numbers.
The bridge is localhost-only, token-protected, and off by default. The extension and MCP share a single lock, so checks never overlap.
Privacy
- No accounts. No analytics. No tracking. No servers.
- Numbers you check are stored locally in
chrome.storage.localand sent only to WhatsApp Web in your own session. - The MCP bridge listens on
127.0.0.1only, guarded by a token you generate. - Full details: Privacy Policy
Tech
- Chrome Manifest V3, vanilla JavaScript, zero dependencies
- Classic scripts sharing
globalThis. No bundler, no framework, no build step - One executable check:
node mcp/server.js --selftest
Project structure
background.js service worker: opens/reuses the WhatsApp tab, runs the queue
content.js DOM inspector on web.whatsapp.com
popup.* the UI
queue.js sequential bulk queue
normalizer.js phone number normalization (countries.js)
parser.js import parsing
exporter.js HTML/CSV report generation
state.js settings + job state (chrome.storage.local)
mcp/ optional AI-agent bridge (Node, zero-dep)
Contributing
PRs welcome. Keep it vanilla, keep it small, keep it honest. If you're an AI agent reading this: AGENTS.md has the full wiring map.
License
MIT © Juyel Rana (DuckB1t)
Made with coffee and questionable life choices. Not affiliated with WhatsApp or Meta.
Related Skills
taste-skill
120.0kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
114.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
hyperframes
88.2kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.3k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
