Areacode.fyi Mcp Server
About
North American NANP area-code and phone-number intelligence for AI agents: area-code lookup, NANP validation, local time, city/state/province coverage, overlays, scam/spoofing context, and block-allocation carrier metadata backed by areacode.fyi.
Details
- Author
- riv-lc
- Downloads
- 280
- Categories
- Communication, Other, API
Jump to
- North American area‑code lookup for US & Canada
- NANP phone‑number validation
- Local time retrieval for any area code
- City and state coverage information
- Overlay area‑code detection
- Scam and spoofing context
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Areacode.fyi Mcp ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Configure the server as an MCP tool in agent platforms such as Claude or Cursor. It calls the public areacode.fyi JSON API to fetch data. No installation steps beyond standard MCP server setup are described in the README.
lookup_area_code
Look up a North American (NANP) area code: country, state/province, principal city and served cities, time zone, current local time, 10-digit-dialing flag, overlay codes, and nearby codes. Returns a canonical areacode.fyi URL and the NANPA source date.
lookup_phone_number
Parse and validate a US/Canada (NANP) phone number. Returns whether the format is valid, the E.164 form, the area code, the likely region and time zone, and the current local time there. Area-code level only — NOT the caller's identity, exact location, or live carrier; caller ID can be spoofed.
lookup_carrier
Look up the carrier, line type (wireless/landline), and rate center that a US/Canada number's NPA-NXX block was assigned to — covering nearly every active area code. Based on public block-allocation data, NOT a live lookup: if the number was ported the current carrier differs. Not for caller identity, fraud, or FCRA decisions.
area_codes_for_city
List the area codes that serve a US or Canadian city. Optionally pass a state/province to disambiguate cities that share a name.
area_codes_for_state
List every area code in a US state or Canadian province.
is_scam_area_code
Explain whether an area code is associated with scams. An area code is never a scam by itself; returns that context + spoofing notes, PLUS an aggregate of public FTC Do Not Call complaints about specific numbers shown with that code (how many flagged numbers, total complaints, top subjects, worst offenders).
check_number_reputation
Spam signal for a US/Canada number from areacode.fyi: the UNVERIFIED crowd-sourced community signal ('low' = looked up, 'mid'/'high' = user reports) PLUS public FTC Do Not Call complaint data when present (complaint count, % robocalls, top subject, date range). Caller ID can be spoofed — none of this proves a number is currently fraudulent.
explain_area_code_topic
Source-backed explanation of a phone-numbering topic, suitable for answering end users.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"areacode.fyi mcp server": {
"areacode": {
"command": "npx",
"args": [
"-y",
"@riv-lc/areacode-mcp"
]
}
}
}
}McpServers
{
"areacode": {
"command": "npx",
"args": [
"-y",
"@riv-lc/areacode-mcp"
]
}
}North American (NANP) area-code & phone-number intelligence for AI agents.
AnMCPserver that gives Claude, Cursor, and other agents a small, trusted reference for US & Canada phone numbering — area codes, NANP validation, local time, city/state coverage, overlays, and scam/spoofing context. Backed byareacode.fyi, which publishes directly from the official NANPA numbering database. Every result includes a canonicalareacode.fyiURL and the source date.
Scope.This is area-code-levelreference and education— not a carrier/identity API. It doesnotreturn a caller's identity, exact location, or live/ported carrier, and caller ID can be spoofed, so a number's area code never proves who is calling. For caller identity you need a carrier-grade (LRN/HLR) provider.
Run it withnpx(no install needed) — add it to your client's MCP config.
Claude Desktop(claude_desktop_config.json) /Cursor(~/.cursor/mcp.json):
{ "mcpServers": { "areacode": { "command": "npx", "args": ["-y", "@riv-lc/areacode-mcp"] } } }
That's it — restart your client and the tools below are available.
Published on theofficial MCP Registryasio.github.riv-lc/areacode-mcp, and onnpm.
Remote (hosted) — for ChatGPT, Claude.ai, and web clients
No install. Add the hosted server as a connector URL — same 8 tools, no key:
(legacy SSE clients:https://mcp.areacode.fyi/sse)
- "A lead entered phone number +1 702-555-0199. Where are they likely located and what time is it there?"
- "I got a call from 469 — is that area code suspicious?"
- "Which area codes cover Las Vegas?"
- "Normalize this list of US/Canada numbers and flag any that are invalid or toll-free."
- "Explain neighbor spoofing for a help-center article."
Tools call the publichttps://areacode.fyi/api/v1JSON API, which reads the same dataset the site renders — sourced from the officialNorth American Numbering Plan Administrator (NANPA)database and refreshed monthly. Each response carriessource,canonical_url, anddata_dateso answers can cite where the data came from.
Thecheck_number_reputationsignal isunverified and crowd-sourced(low= people looked the number up;mid/high= it has user reports). It is never proof that a specific number is fraudulent.
MIT © Reindex Ventures. Built forareacode.fyi.
Enables seamless integration with communication platform that allows you to reach your customers globally across any channel.
Interact with any other SaaS applications on behalf of your customers.
Official MCP Server to interact with Pearl API. Connect your AI Agents with 12,000+ certified experts instantly.
Platfone - Receive SMS & Virtual Numbers MCP
Virtual phone number platform for AI agents — rent numbers across 200+ countries, receive SMS, and manage the full activation lifecycle
Send emails directly from your editor using the Resend API.
Sendmux is an email inbox API and email API for AI agents.
Sinch Engage (Sinch MessageMedia in AU) MCP server, which provides Sinch Engage APIs as MCP tools.
Wavix is a global communications platform offering APIs for voice, SMS, 2FA, and phone numbers. Our MCP server brings these capabilities to AI agents and agentic workflows.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
