Phone Number Validation & E.164 Normalization

omnial/x402-phone-normalize

Given a phone number (and an optional ISO 2-letter country code hint), returns whether it is a valid, possible number, its E.164/national/international formatted forms, the detected country and calling code, and a line-type indicator -- or a parse error when the number cannot be normalized at all.

activeper callv3

Price

Up to $0.0487 per call; you pay what the call used

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.

Data source

Google libphonenumber

Data from Google libphonenumber.

Use it

Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.

Connect once and your AI can find and run this tool, and any other it needs.

Install it Create an account

For developers: the calls your assistant makes

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/x402-phone-normalize" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/x402-phone-normalize" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/x402-phone-normalize", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/x402-phone-normalize", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.0487

Updated: Oct 27, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "phone_string"
  ],
  "properties": {
    "phone_string": {
      "type": "string",
      "description": "Phone number to normalize"
    },
    "default_country": {
      "type": "string",
      "description": "ISO country code (e.g. SE)"
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "required": [
    "input",
    "valid"
  ],
  "properties": {
    "e164": {
      "type": "string",
      "description": "E.164-formatted number (e.g. '+12125550198'). Only present on a valid number -- absent when the number could not be parsed at all."
    },
    "type": {
      "type": "string",
      "description": "Line type, e.g. 'FIXED_LINE_OR_MOBILE' -- typically a single combined category; other values are documented by the source but not confirmed."
    },
    "error": {
      "type": "string",
      "description": "A human-readable parse-failure message, present instead of the normalized fields above when the number could not be parsed (e.g. too short, no country context)."
    },
    "input": {
      "type": "string",
      "description": "The phone number text exactly as submitted, echoed back."
    },
    "valid": {
      "type": "boolean",
      "description": "Whether the number is a fully valid number for its detected region."
    },
    "is_possible": {
      "type": "boolean",
      "description": "Whether the number's length/shape is at least plausible for its region. Only observed on a valid number."
    },
    "calling_code": {
      "type": "string",
      "description": "Detected calling code (e.g. '+1'). Only observed on a valid number."
    },
    "country_code": {
      "type": "string",
      "description": "Detected ISO country code (e.g. 'US'). Only observed on a valid number."
    },
    "national_format": {
      "type": "string",
      "description": "Locally-formatted number (e.g. '(212) 555-0198'). Only observed on a valid number."
    },
    "international_format": {
      "type": "string",
      "description": "Internationally-formatted number (e.g. '+1 212 555 0198'). Only observed on a valid number."
    }
  },
  "description": "The phone normalization result.",
  "additionalProperties": true
}