Skip to content
MCP server

PhoneCheck

Offline phone number validation and formatting for AI agents and developers

Install
Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
0.2.1
Listing updated
1 day ago

About PhoneCheck

PhoneCheck is a freemium MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://phonecheck.mike-tusa.workers.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "phonecheck": {
      "url": "https://phonecheck.mike-tusa.workers.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Freemium

Free light use per IP; Pro keys for bulk, prices not published

Prices change. Check phonecheck.mike-tusa.workers.dev before you buy.

PhoneCheck 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 to PhoneCheck

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools