Phone Number Type & Line Classifier

omnial/x402-phone-type-detect

Given a phone number (and an optional ISO 2-letter country code hint), returns its detected line type (mobile, landline, VOIP, toll-free, or premium rate), whether it can receive SMS, and simple mobile/landline/VOIP/toll-free/premium flags -- useful for deciding whether a number is worth texting or how to route an outbound call. Line type comes from numbering-plan ranges, not a carrier lookup, so North American numbers cannot be split: in testing a US landline came back as fixed_line_or_mobile with is_mobile, is_landline and sms_capable all true.

activeper callv5

Price

Up to $0.0325 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-type-detect" })

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

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/x402-phone-type-detect", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/x402-phone-type-detect", 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.0325

Updated: Oct 27, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "phone_number"
  ],
  "properties": {
    "country_code": {
      "type": "string",
      "description": "ISO 2-letter country code hint (optional)"
    },
    "phone_number": {
      "type": "string",
      "description": "Phone number in any format"
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "input": {
      "type": "string",
      "description": "The phone number exactly as submitted, echoed back."
    },
    "is_voip": {
      "type": "boolean",
      "description": "Whether the number is classified as a VOIP line."
    },
    "is_mobile": {
      "type": "boolean",
      "description": "Whether the number is classified as (or could be) a mobile line."
    },
    "is_premium": {
      "type": "boolean",
      "description": "Whether the number is a premium-rate number."
    },
    "phone_type": {
      "type": "string",
      "description": "The detected line type, e.g. 'fixed_line_or_mobile' or 'toll_free'. Observed values are lowercase, underscore-separated category strings."
    },
    "is_landline": {
      "type": "boolean",
      "description": "Whether the number is classified as (or could be) a fixed landline."
    },
    "sms_capable": {
      "type": "boolean",
      "description": "Whether the number can plausibly receive SMS messages."
    },
    "country_code": {
      "type": "string",
      "description": "ISO 2-letter country code the number was resolved against."
    },
    "is_toll_free": {
      "type": "boolean",
      "description": "Whether the number is a toll-free number (e.g. a US 1-800 number)."
    }
  },
  "description": "The phone type detection result.",
  "additionalProperties": true
}