Skip to main content
Glama

Tanod Util

utilpeek: parse and format a phone number (numbering-plan check)

parse_phone_number
Read-onlyIdempotent

utilpeek: parse and format a phone number. Input: number. Returns valid, possible, e164, international, national, rfc3966, country_calling_code, region, type (mobile, fixed_line, toll_free, ...), carrier, location and timezones. A string that is not a phone number, or a national form without region, is a 422 (not charged). Offline numbering-plan check (phonenumbers, Apache-2.0): valid means the number fits its country's numbering plan, not that it is assigned, in service or reachable; carrier is the original range holder (ported numbers are not detected). The submitted value is processed in memory only, never logged or stored. Typically under 0.1 s. Price: USD 0.001. Free: 10 utilpeek calls per IP per UTC day. Docs: https://tanod.dev/learn/phone-number-validation-api.html

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
numberYesPhone number: +CC international form, or national form with region.
regionNoOptional ISO 3166-1 alpha-2 region for a national-form number (e.g. US).

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
e164No
noteNo
typeNo
errorNoOnly on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object.
validNo
regionNo
sourceNo
carrierNo
rfc3966No
locationNo
nationalNo
possibleNo
extensionNo
timezonesNo
internationalNo
country_calling_codeNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "carrier": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "country_calling_code": {
      +      "type": [
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "e164": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "error": {
      +      "description": "Only on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object."
      +    },
      +    "extension": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "international": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "location": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "national": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "note": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "possible": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "region": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "rfc3966": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "source": {
      +      "properties": {
      +        "library": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "license": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "url": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "timezones": {
      +      "items": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    },
      +    "type": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "valid": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
  2. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources