Server data from the Official MCP Registry
North American (NANP) area-code & phone-number intelligence for AI agents, by areacode.fyi.
About
North American (NANP) area-code & phone-number intelligence for AI agents, by areacode.fyi.
Security Report
Valid MCP server (2 strong, 2 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.
4 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: AREACODE_API_BASE
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-riv-lc-areacode-mcp": {
"args": [
"-y",
"@riv-lc/areacode-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
areacode-mcp
North American (NANP) area-code & phone-number intelligence for AI agents.
An MCP server 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 by areacode.fyi, which
publishes directly from the official NANPA numbering database. Every result
includes a canonical areacode.fyi URL and the source date.
Scope. This is area-code-level reference and education — not a carrier/identity API. It does not return 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.
Install
Run it with npx (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 the official MCP Registry as io.github.riv-lc/areacode-mcp, and
on npm.
Remote (hosted) — for ChatGPT, Claude.ai, and web clients
No install. Add the hosted server as a connector URL — same 8 tools, no key:
https://mcp.areacode.fyi/mcp
(legacy SSE clients: https://mcp.areacode.fyi/sse)
Tools
| Tool | What it does |
|---|---|
lookup_area_code | Country, state/province, cities, time zone, current local time, overlays, nearby codes |
lookup_phone_number | Parse/validate a NANP number → area code, region, local time, E.164 |
lookup_carrier | Assigned carrier, line type (wireless/landline), and rate center for a number's NPA-NXX block (block-allocation data, not live/ported; covers nearly every US/Canada code) |
area_codes_for_city | Area codes serving a city (optionally disambiguated by state) |
area_codes_for_state | Every area code in a US state or Canadian province |
is_scam_area_code | Scam/spoofing context for an area code + an aggregate of FTC Do Not Call complaints filed about numbers using that code |
check_number_reputation | Unverified community signal (low / mid / high) plus public FTC Do Not Call complaint data (count, % robocalls, top subject) for a number |
explain_area_code_topic | Source-backed explainers: neighbor spoofing, overlays vs splits, toll-free, area-code-vs-country-code, temporary numbers |
Example prompts
- "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."
Configuration
| Env var | Default | Purpose |
|---|---|---|
AREACODE_API_BASE | https://areacode.fyi | Point at a different host (e.g. a self-hosted or staging API) |
Data & sourcing
Tools call the public https://areacode.fyi/api/v1 JSON API, which reads the
same dataset the site renders — sourced from the official North American
Numbering Plan Administrator (NANPA) database and refreshed monthly. Each
response carries source, canonical_url, and data_date so answers can cite
where the data came from.
The check_number_reputation signal is unverified 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.
License
MIT © Reindex Ventures. Built for areacode.fyi.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.