# NumRadar

> NumRadar is a paid MCP server for communication. Check whether phone numbers are registered on WhatsApp, one or 10,000 at a time. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Paid
- **Starting price:** $9 a month
- **Platforms:** API, CLI, Web
- **Website:** https://numradar.app/mcp-server
- **Repository:** https://github.com/numradar/mcp
- **MCP Registry name:** app.numradar/mcp
- **Categories:** communication, analytics and data
- **Listing updated:** 2026-11-15

## About

NumRadar answers a single question, whether a number is on WhatsApp, and this server hands that to an agent. It runs hosted at numradar.app/mcp over streamable HTTP with a bearer key, or locally through the @numradar/mcp npm package for clients like Claude Desktop that only spawn commands. It does not support OAuth yet, so apps that connect remote servers only through OAuth must use the local package.

Single checks return registration status, business account, line type and country. Bulk jobs take up to 10,000 numbers and return a job ID to poll. Billing is the part that shapes agent behaviour: only registered and not-registered results use a check, while invalid numbers and failed lookups cost nothing, so the README advises agents to send questionable numbers instead of pre-filtering them. Numbers should be in E.164 format.

Three prompts appear as slash commands: check_numbers, clean_contact_list and check_before_spending. MCP use needs a paid plan, which starts at 9 euros a month for 5,000 validations, sharing the same allowance and rate limits as the REST API.

## Features

- **Single number check:** Returns WhatsApp registration, business account, line type and country.
- **Bulk validation:** Submit up to 10,000 numbers and poll one job for results.
- **Balance check:** Lets the agent see remaining allowance before a large run.
- **Job history:** List recent jobs so an agent can resume earlier work.
- **Slash-command prompts:** check_numbers, clean_contact_list and check_before_spending.
- **Hosted or local:** Use the hosted URL or run npx @numradar/mcp with an API key.

## Good for

- Clean a contact list before a WhatsApp campaign
- Estimate the cost of validating a list before spending
- Verify a lead's number during a chat session
- Run an overnight bulk validation and collect results later

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://numradar.app/mcp
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://numradar.app/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://numradar.app/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://numradar.app/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://numradar.app/mcp"
    }
  }
}
```

## Tools

- `validate_number`: Checks one phone number for WhatsApp registration and account details.
- `bulk_validate`: Starts a bulk job of up to 10,000 numbers and returns a job ID.
- `get_job_status`: Returns progress and results for a bulk job.
- `list_jobs`: Lists recent bulk jobs.
- `get_balance`: Shows the remaining allowance.

## FAQ

### What counts as a validation?

A registered or not-registered result; invalid numbers and failed lookups use no allowance.

### Do I need a paid plan?

Yes, the site says a paid plan and an nr_live_ API key are required.

### How much does it cost?

Plans start at 9 euros a month for 5,000 validations and go up to 249 euros for 300,000.

### Can I use it from Claude.ai's custom connector?

No, because it has no OAuth sign-in yet; use the local npm package where the app allows it.

### What number format is expected?

E.164, for example +14155550100.

### Is NumRadar free?

No. NumRadar is a paid product. Paid plans start at $9 a month.

### How do I add NumRadar to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://numradar.app/mcp

### What are the best alternatives to NumRadar?

The closest alternatives to NumRadar are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.

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