# Realphonevalidation — how to use (mcp.ai)

Connect your Realphonevalidation account and use 10 tools for phone and SMS straight from your AI agent. Connect with your own API key. RealPhoneValidation offers real-time phone number validation services, providing information on connectivity, phone type, carrier, and more.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_realphonevalidation?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `realphonevalidation_check_fraud`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/realphonevalidation`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/realphonevalidation/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/realphonevalidation/check/fraud` — Tool to check phone number for fraud risk using Fraud Check API. Provides a phone risk score and many actionable data points including phone type, carrier, location, and recommendation (block, flag, a
  - body: { phone: string, output?: string }
- `POST https://api.mcp.ai/api/realphonevalidation/email/verify` — Tool to validate an email address and check connectivity and disposability. Use after gathering an email to ensure it's deliverable and not disposable.
  - body: { email: string, token: string, output?: string }
- `POST https://api.mcp.ai/api/realphonevalidation/lookup/dnc` — Tool to check Do Not Call list status for US phone numbers. Determines if number is on National, State, or DMA Do Not Call lists, identifies cell vs landline, and checks for known TCPA litigators. Req
  - body: { phone: string, token: string, output?: string }
- `POST https://api.mcp.ai/api/realphonevalidation/rpv/active` — Tool to determine if a phone number is active on a valid phone service provider. Use after collecting the user's phone number for real-time verification.
  - body: { phone: string, token: string, output?: string }
- `POST https://api.mcp.ai/api/realphonevalidation/rpv/reassigned/number/lookup` — Tool to check if a phone number has been reassigned since a given consent date. Use when verifying number ownership status after obtaining user consent.
  - body: { phone: string, token: string, output?: string, contact_date: string }
- `POST https://api.mcp.ai/api/realphonevalidation/rpv/scrub/plus` — Tool to scrub a phone number for connection status and type. Use to validate a US phone number's status and line type.
  - body: { phone: string, token: string }
- `POST https://api.mcp.ai/api/realphonevalidation/rpv/wireless/id` — Tool to identify whether a US phone number is landline or wireless. Use when conducting TCPA compliance checks.
  - body: { phone: string, token: string, output?: string }
- `POST https://api.mcp.ai/api/realphonevalidation/validate/phone/scrub` — Tool to validate US phone numbers using budget-friendly Scrub API. Determines connectivity status quickly (under 2 seconds). Best for organizations with large lists/databases on tight budgets that onl
  - body: { phone: string, token: string, output?: string }
- `POST https://api.mcp.ai/api/realphonevalidation/validate/phone/turbo/standard` — Tool to perform real-time US phone validation using Turbo Standard API. Provides connection status and phone type (Mobile, Landline, VoIP). Optimized for web forms and apps when only connection status
  - body: { phone: string, token: string, output?: string }
- `POST https://api.mcp.ai/api/realphonevalidation/validate/phone/turbo/v3` — Tool to perform comprehensive real-time phone validation using Turbo V3 API. Returns connection status, phone type (landline, cell, VoIP), carrier ID, caller name (when available), and caller type (co
  - body: { phone: string, output?: string }

## Example prompts
- "What can I do in Realphonevalidation?"
- "Show me a summary of my Realphonevalidation account"

## More
- Page: https://mcp.ai/realphonevalidation
- Agent spec (llms.txt): https://mcp.ai/realphonevalidation/llms.txt
- Postman collection: https://mcp.ai/realphonevalidation/postman.json