{
  "markdown": "# Phone Number Validation API\n\n[![MCP Server](https://img.shields.io/badge/MCP-server-blue)](https://phone-validation.api.klymax402.com/mcp)\n[![x402](https://img.shields.io/badge/payments-x402-6E56CF)](https://x402.org)\n[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)\n\nValidate phone numbers worldwide -- carrier, line type, country, E.164 format. Single and batch (50) modes. Pay-per-call via [x402](https://x402.org) (USDC on Base L2) -- no API key, no signup, no rate-limit wall.\n\nPart of the [klymax402](https://klymax402.com) marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.\n\n## Quickstart -- MCP\n\nAdd to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"phone-validation\": {\n      \"url\": \"https://phone-validation.api.klymax402.com/mcp\"\n    }\n  }\n}\n```\n\n## Quickstart -- HTTP (x402)\n\n```bash\ncurl \"https://phone-validation.api.klymax402.com/api/validate?phone=...\"\n# -> 402 Payment Required, with an x402 payment challenge in the response body\n```\n\nAny x402-aware client ([`@x402/fetch`](https://www.npmjs.com/package/@x402/fetch), [`x402-agent-tools`](https://www.npmjs.com/package/x402-agent-tools), ATXP) handles the 402 -> sign -> retry cycle automatically.\n\n## Tools\n\n| Tool | Method | Path | Price | Description |\n|---|---|---|---|---|\n| `phone_validate_number` | GET | `/api/validate` | $0.008 | Validate a phone number and get carrier/type/country info |\n| `phone_validate_batch` | POST | `/api/validate/batch` | $0.035 | Validate up to 50 phone numbers in a single batch request |\n\n### `phone_validate_number`\n\nUse this when you need to validate a phone number and get carrier info. Returns structured validation data in JSON.\n\n**Parameters**\n\n| Name | Type | Required | Description |\n|---|---|---|---|\n| `phone` | string | yes | Phone number to validate (e.g. +33612345678, +14155552671, 0033612345678) |\n\nExample response:\n\n```json\n{\"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\"}\n```\n\n**When to use**: sending SMS or calling a number, FOR CRM data cleaning, lead validation, fraud detection, and KYC phone verification.\n\n**Not for**: SMS capability check (use `sms_validate_number`), email validation (use `email_verify_address`), person data (use `person_enrich_from_email`).\n\n### `phone_validate_batch`\n\nUse this when you need to validate multiple phone numbers at once (up to 50). Returns an array of validation results in JSON.\n\n**Parameters**\n\n| Name | Type | Required | Description |\n|---|---|---|---|\n| `phones` | array | yes | Array of phone numbers to validate (max 50) |\n\nExample response:\n\n```json\n{\"results\":[{\"phone\":\"+14155551234\",\"valid\":true,\"e164\":\"+14155551234\",\"countryCode\":\"US\",\"carrier\":\"T-Mobile\",\"lineType\":\"mobile\"},{\"phone\":\"invalid\",\"valid\":false}],\"total\":2,\"validCount\":1}\n```\n\n**When to use**: bulk CRM cleaning, importing contact lists, deduplication pipelines, and batch lead validation.\n\n**Not for**: single numbers (use `phone_validate_number`), SMS capability (use `sms_validate_number`).\n\n## Example agent prompts\n\n- \"Validate a phone number and get carrier info\"\n- \"Validate multiple phone numbers at once (up to 50)\"\n\n## Payment\n\n- Protocol: [x402](https://x402.org) -- HTTP-native pay-per-call, no signup, no API key\n- Network: Base L2 (`eip155:8453`)\n- Asset: USDC\n- Facilitator: Coinbase CDP (primary), PayAI (fallback)\n- Also reachable via [ATXP](https://atxp.ai) (OAuth-wrapped x402, RFC 9728 protected-resource metadata)\n\n## Part of klymax402\n\n100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.\n\n- Catalog: https://klymax402.com/llms.txt\n- Full API reference: https://klymax402.com/llms-full.txt\n- Live stats: https://klymax402.com/stats\n\n## License\n\nMIT\n",
  "bytes": 3900,
  "sha": "545888627e3bf6838b714127903dae1d73fed53822772983c1b60516a8fc3aa5",
  "repo_slug": "br0ski777/phone-validation-x402",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_br0ski777_phone_validation_f63c02af/readme"
}