Phone Number Validation API

السجل الرسمي أخرى

Validate phone numbers worldwide: carrier, line type, country, E.164. x402.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (sse)
Claude Code
claude mcp add --transport sse phone-number-validation-api 'https://phone-validation.api.klymax402.com/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "phone-number-validation-api": {
            "type": "sse",
            "url": "https://phone-validation.api.klymax402.com/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Phone Number Validation API
  2. Quickstart -- MCP
  3. Quickstart -- HTTP (x402)
  4. Tools
  5. Example agent prompts
  6. Payment
  7. Part of klymax402
  8. License

Phone Number Validation API

Validate phone numbers worldwide -- carrier, line type, country, E.164 format. Single and batch (50) modes. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.

Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.

Quickstart -- MCP

Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):

{
  "mcpServers": {
    "phone-validation": {
      "url": "https://phone-validation.api.klymax402.com/mcp"
    }
  }
}

Quickstart -- HTTP (x402)

curl "https://phone-validation.api.klymax402.com/api/validate?phone=..."
# -> 402 Payment Required, with an x402 payment challenge in the response body

Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.

Tools

ToolMethodPathPriceDescription
phone_validate_numberGET/api/validate$0.008Validate a phone number and get carrier/type/country info
phone_validate_batchPOST/api/validate/batch$0.035Validate up to 50 phone numbers in a single batch request
phone_validate_number

Use this when you need to validate a phone number and get carrier info. Returns structured validation data in JSON.

Parameters

NameTypeRequiredDescription
phonestringyesPhone number to validate (e.g. +33612345678, +14155552671, 0033612345678)

Example response:

{"valid":true,"e164":"+33612345678","countryCode":"FR","countryName":"France","carrier":"Orange","lineType":"mobile","localFormat":"06 12 34 56 78","internationalFormat":"+33 6 12 34 56 78"}

When to use: sending SMS or calling a number, FOR CRM data cleaning, lead validation, fraud detection, and KYC phone verification.

Not for: SMS capability check (use sms_validate_number), email validation (use email_verify_address), person data (use person_enrich_from_email).

phone_validate_batch

Use this when you need to validate multiple phone numbers at once (up to 50). Returns an array of validation results in JSON.

Parameters

NameTypeRequiredDescription
phonesarrayyesArray of phone numbers to validate (max 50)

Example response:

{"results":[{"phone":"+14155551234","valid":true,"e164":"+14155551234","countryCode":"US","carrier":"T-Mobile","lineType":"mobile"},{"phone":"invalid","valid":false}],"total":2,"validCount":1}

When to use: bulk CRM cleaning, importing contact lists, deduplication pipelines, and batch lead validation.

Not for: single numbers (use phone_validate_number), SMS capability (use sms_validate_number).

Example agent prompts

  • "Validate a phone number and get carrier info"
  • "Validate multiple phone numbers at once (up to 50)"

Payment

  • Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
  • Network: Base L2 (eip155:8453)
  • Asset: USDC
  • Facilitator: Coinbase CDP (primary), PayAI (fallback)
  • Also reachable via ATXP (OAuth-wrapped x402, RFC 9728 protected-resource metadata)

Part of klymax402

100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.

License

MIT

الأسئلة الشائعة

ما هو Phone Number Validation API؟

Validate phone numbers worldwide: carrier, line type, country, E.164. x402.

كيف أثبّت Phone Number Validation API؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport sse phone-number-validation-api 'https://phone-validation.api.klymax402.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Phone Number Validation API إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Phone Number Validation API مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Phone Number Validation API؟

ينشره Br0ski777. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.