Areacode.fyi Mcp Server
@riv-lc
About Areacode.fyi Mcp Server
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.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"areacode": {
"command": "npx",
"args": [
"-y",
"@riv-lc/areacode-mcp"
]
}
}
}Tools
8Look 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.
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.
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.
List the area codes that serve a US or Canadian city. Optionally pass a state/province to disambiguate cities that share a name.
List every area code in a US state or Canadian province.
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).
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.
Source-backed explanation of a phone-numbering topic, suitable for answering end users.
Overview
What is Areacode.fyi MCP Server?
An MCP server that provides North American (NANP) area‑code and phone‑number intelligence to AI agents. It offers a trusted reference for US and Canada phone numbering — including area codes, NANP validation, local time, city/state coverage, overlays, and scam/spoofing context. Backed by the areacode.fyi website, which publishes directly from the official NANPA numbering database.
How to use Areacode.fyi MCP Server?
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.
Key features of Areacode.fyi MCP Server
- 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
Use cases of Areacode.fyi MCP Server
- Validate a phone number’s NANP format during customer intake
- Look up the local time of an area code for scheduling
- Identify city/state coverage for a given area code
- Check whether an area code has overlays or is associated with scams
- Generate cited area‑code answers with canonical source URLs
FAQ from Areacode.fyi MCP Server
What area codes does the server cover?
It covers all North American Numbering Plan (NANP) area codes for the United States and Canada.
Where does the data come from?
The data is sourced from the official North American Numbering Plan Administrator (NANPA) database and is refreshed monthly.
How does an agent access the areacode.fyi data?
The MCP server’s tools call the public areacode.fyi API (https://areacode.fyi/api/v1), which returns the same dataset used by the website.
Does each response include a source citation?
Yes. Every response carries a canonical_url, source, and data_date field so answers can cite where the data came from.
Is the API public and free to use?
The README describes the API as public, but does not explicitly state pricing or usage limits.
Frequently asked questions
What area codes does the server cover?
It covers all North American Numbering Plan (NANP) area codes for the United States and Canada.
Where does the data come from?
The data is sourced from the official North American Numbering Plan Administrator (NANPA) database and is refreshed monthly.
How does an agent access the areacode.fyi data?
The MCP server’s tools call the public areacode.fyi API (https://areacode.fyi/api/v1), which returns the same dataset used by the website.
Does each response include a source citation?
Yes. Every response carries a `canonical_url`, `source`, and `data_date` field so answers can cite where the data came from.
Is the API public and free to use?
The README describes the API as public, but does not explicitly state pricing or usage limits.
Basic information
More Other MCP servers
Sequential Thinking
modelcontextprotocolModel Context Protocol Servers
Activepieces
activepiecesAI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
AutoBrowser MCP
autobrowser-aiBrowser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser
ghidraMCP
LaurieWiredMCP Server for Ghidra
Glasswarp
GlasswarpSee and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.
Comments