# Data247 — how to use (mcp.ai)

Connect your Data247 account and use 24 tools for developer tools straight from your AI agent. Connect with your own API key. Data247 is a simple, and secure on-demand data platform that provides businesses with a wide-range of data lookup services.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_data247?ms=1787291460000`
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. `data247_append_email2`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/data247`
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/data247/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/data247/append/email2` — Tool to find email addresses associated with name and postal address using Append247 service. Use when you need to discover the email address for a contact given their name and address details (all fi
  - body: { zip?: string, city?: string, fname?: string, lname?: string, state?: string, address?: string }
- `POST https://api.mcp.ai/api/data247/append/gender` — Tool to determine a person's probable gender based on their first (given) name. Use when you need to infer gender from a first name with confidence percentage.
  - body: { out?: string, fname: string }
- `POST https://api.mcp.ai/api/data247/append/name` — Tool to get CNAM (Caller Name Delivery) data for a phone number. Use when you need to find the registered owner name associated with a phone number from carrier-grade telco data.
  - body: { out?: string, phone: string }
- `POST https://api.mcp.ai/api/data247/append/phone` — Tool to append phone numbers to contact records using name and address. Use when you need to find phone numbers (business or residential) associated with a person's name and address. Returns primary p
  - body: { zip: string, city: string, state: string, address: string, lastname: string, firstname: string }
- `POST https://api.mcp.ai/api/data247/append/profile` — Tool to retrieve comprehensive consumer profile data including identity, contact information, demographics, property, and vehicle details. Use when you need detailed profile enrichment for a person ba
  - body: { zip?: string, city?: string, state?: string, address?: string, lastname?: string, firstname?: string }
- `POST https://api.mcp.ai/api/data247/append/property/data` — Tool to retrieve comprehensive property data including home stats, ownership information, financials and foreclosure data. Use when you need detailed property information for any US address.
  - body: { out?: string, zip: string, city: string, state: string, address: string }
- `POST https://api.mcp.ai/api/data247/append/reverse/email` — Tool to perform reverse email lookup and retrieve contact information. Use when you need to find the name, phone, and address associated with an email address. Returns personal identifiers, contact de
  - body: { email: string }
- `POST https://api.mcp.ai/api/data247/append/reverse/phone` — Tool to perform reverse phone lookup and retrieve name and address information. Use when you need to find the contact details associated with a phone number. Returns personal identifiers, address comp
  - body: { phone: string }
- `POST https://api.mcp.ai/api/data247/append/reverse/zipcode` — Tool to get formatted address components from a zipcode. Use when you need to retrieve city, state, county, congressional district, timezone, and other location data for a given 5 or 9 digit zipcode.
  - body: { zip: string, plus4?: string }
- `POST https://api.mcp.ai/api/data247/append/zipcode2` — Tool to lookup zipcode for an address based on city and state. Use when you need to obtain zipcodes for a location specified by city and state, with optional street address for more precise results.
  - body: { zip?: string, city?: string, state?: string, address?: string, lastname?: string, firstname?: string }
- `POST https://api.mcp.ai/api/data247/balance/inquiry` — Tool to check Data247 account balance and remaining credits. Use when you need to verify available credits before making API requests.
- `POST https://api.mcp.ai/api/data247/carrier/type` — Tool to determine carrier type for USA and Canadian phone numbers. Use when you need to identify if a phone number is a Mobile, Landline, or VOIP line. Returns the carrier type classification for the 
  - body: { phone: string }
- `POST https://api.mcp.ai/api/data247/dnc/add` — Tool to add phone numbers to your internal do-not-call (DNC) list. Use when you need to mark phone numbers that should not be contacted. Returns confirmation with action status 'ADDED' for successfull
  - body: { phone: string }
- `POST https://api.mcp.ai/api/data247/dnc/check` — Tool to check if a phone number exists in Federal or internal Do-Not-Call list. Use when you need to verify if a phone number is safe to dial or if it's on a DNC list. Returns status indicating whethe
  - body: { phone: string }
- `POST https://api.mcp.ai/api/data247/dnc/remove` — Tool to remove phone numbers from your internal do-not-call (DNC) list. Use when you need to unmark phone numbers that were previously marked as do-not-call. Returns confirmation with action status 'R
  - body: { phone: string }
- `POST https://api.mcp.ai/api/data247/locate/ip/address` — Tool to get geolocation data for IPv4 addresses including city, state, country, and coordinates. Use when you need to determine the geographic location of an IP address worldwide.
  - body: { ip: string }
- `POST https://api.mcp.ai/api/data247/lookup/carrier/usa` — Tool to look up carrier information for USA and Canadian phone numbers including carrier name, SMS/MMS gateway addresses, and wireless status. Use when you need to determine if a phone is wireless, ge
  - body: { phone: string }
- `POST https://api.mcp.ai/api/data247/lookup/international/carrier` — Tool to get carrier information for international phone numbers worldwide. Use when you need to obtain carrier name, wireless status, country, and ISO country code for international numbers. Note: SMS
  - body: { phone: string }
- `POST https://api.mcp.ai/api/data247/text/at` — Tool to get carrier information, wireless status, and email-to-SMS/MMS gateway addresses for USA and Canadian phone numbers using the Text@ service. Use when you need to obtain carrier name, determine
  - body: { phone: string }
- `POST https://api.mcp.ai/api/data247/trust/phone` — Tool to check if a phone number is on SPAM callers list. Use when you need to verify if a phone number has been reported as spam or fraud. Returns spam risk level (Low, Medium, or High) and reason for
  - body: { phone: string }
- `POST https://api.mcp.ai/api/data247/trust/user/identity` — Tool to verify user signup legitimacy and detect account creation fraud. Use when you need to check if a new user signup is from a legitimate user or a fraud attempt. Returns a trust score (1-100) and
  - body: { ip?: string, zip?: string, city?: string, email?: string, phone?: string, state?: string, address?: string, lastname?: string, firstname?: string }
- `POST https://api.mcp.ai/api/data247/verify/email` — Tool to verify email address format and mailbox existence. Use when you need to validate that an email address is properly formatted and has a working mailbox. Also identifies free accounts and dispos
  - body: { email: string }
- `POST https://api.mcp.ai/api/data247/verify/phone` — Tool to verify if a phone number is in-service and accepts inbound calls. Use when you need to validate phone number active status with confidence level. Returns whether the phone is active (YES/NO) a
  - body: { phone: string }
- `POST https://api.mcp.ai/api/data247/verify/postal/address` — Tool to verify and correct USA postal addresses to USPS standards. Use when you need to validate an address and get corrected components including street, city, state, ZIP, and detailed location data.
  - body: { zip?: string, city?: string, state?: string, address: string }

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

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