# PhoneCheck

> PhoneCheck is a freemium MCP server for developer tools. Offline phone number validation and formatting for AI agents and developers. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://phonecheck.mike-tusa.workers.dev
- **MCP Registry name:** dev.workers.mike-tusa.phonecheck/phonecheck
- **Categories:** developer tools, communication
- **Listing updated:** 2026-11-16

## About

The checker runs on Google's libphonenumber metadata, so it needs no carrier lookup and no outbound calls. Give it a number in almost any format and it reports whether the digits fit an allocated range or at least a possible length, then returns E.164, international, national and `tel:` forms. For failures it says why: too short, too long, missing country code or an unallocated range.

Line type is returned where the numbering plan defines it (mobile, fixed line, toll-free, premium rate, VoIP and others). Some plans, such as the US and Canada, do not split mobile from fixed line, so those come back as a combined type. The site says numbers are processed in memory and never stored or logged.

The remote MCP endpoint exposes two tools and shares the keys and limits of the JSON API. Light use works without a key under a per-IP limit; Pro keys add a bulk endpoint of up to 500 numbers per request.

## Features

- **E.164 and other formats:** Returns E.164, international, national and RFC 3966 forms.
- **Validity reasons:** States why a number failed, such as too short or no country code.
- **Line type:** Reports mobile, fixed line, toll-free, VoIP and other types when the plan defines them.
- **Region detection:** Gives the ISO country and calling code, or non-geographic for services like +800.
- **Bulk endpoint:** Pro keys can normalise up to 500 numbers in one POST request.

## Good for

- Normalise phone numbers before saving them to a CRM
- Let an agent check a number a user typed in
- Reject impossible numbers in a signup form
- Convert a list into E.164 for an SMS provider

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http phonecheck https://phonecheck.mike-tusa.workers.dev/mcp
```

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

```sh
https://phonecheck.mike-tusa.workers.dev/mcp
```

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

```json
{
  "mcpServers": {
    "phonecheck": {
      "url": "https://phonecheck.mike-tusa.workers.dev/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "phonecheck": {
      "type": "http",
      "url": "https://phonecheck.mike-tusa.workers.dev/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "phonecheck": {
      "serverUrl": "https://phonecheck.mike-tusa.workers.dev/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "phonecheck": {
      "type": "http",
      "url": "https://phonecheck.mike-tusa.workers.dev/mcp"
    }
  }
}
```

## Tools

- `parse_phone_number`: Validate and format a phone number
- `get_example_number`: Return an example number for a region

## FAQ

### Does it look up the carrier?

No. The registry entry says validation is offline with no carrier lookup.

### Are numbers stored?

The site says they are processed in memory and discarded, with only request counts kept.

### Do I need an API key?

Light use works without one under a per-IP rate limit; Pro keys unlock bulk requests.

### Which MCP tools exist?

parse_phone_number and get_example_number.

### Is PhoneCheck free?

PhoneCheck has a free plan, with paid plans for more usage or features.

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

Run this command in your terminal: claude mcp add --transport http phonecheck https://phonecheck.mike-tusa.workers.dev/mcp

### What are the best alternatives to PhoneCheck?

The closest alternatives to PhoneCheck are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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