`validate_phone`

Pack: phone · Endpoint: https://gateway.pipeworx.io/phone/mcp

Validate & parse a phone number against the E.164 / ITU calling-code plan (keyless, offline). Detects the country, normalizes to E.164, and checks the national-number length is plausible. Pass an international number (e.g. “+33 1 23 45 67 89”) OR a national number plus a country ISO code (e.g. phone=“020 7946 0958”, country=“GB”). Does NOT determine carrier or mobile-vs-landline (that needs a keyed HLR lookup).

Parameters

Name	Type	Required	Description
`phone`	string	yes	The phone number to validate (international ”+..” form, or national form with `country`).
`country`	string	no	Optional ISO 3166 alpha-2 country code (e.g. “US”, “GB”, “DE”) used when `phone` is in national (non-+) form.

Example call

Arguments

{
  "phone": "+33 1 23 45 67 89"
}

curl

curl -X POST https://gateway.pipeworx.io/phone/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"validate_phone","arguments":{"phone":"+33 1 23 45 67 89"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('validate_phone', {
  "phone": "+33 1 23 45 67 89"
});

More examples

{
  "phone": "020 7946 0958",
  "country": "GB"
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "phone": {
      "url": "https://gateway.pipeworx.io/phone/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

validate_phone