AreaCode.fyi MCP Server

by riv-lc·io.github.riv-lc/areacode-mcp·v0.2.2

No reviews yet

North American (NANP) area-code & phone-number intelligence for AI agents, by areacode.fyi.

B80/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B80/100

full report

Adoption

New

0 stars45 downloads/wk

Reviews

Write one

Nobody has reviewed AreaCode.fyi MCP Server yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

AreaCode.fyi MCP Server tools (8)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

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.
check_number_reputation
Return the UNVERIFIED, crowd-sourced community signal for a US/Canada number from areacode.fyi: 'low' (people have looked it up), 'mid'/'high' (it has user reports). Caller ID can be spoofed — this is never proof a specific number is fraudulent.
explain_area_code_topic
Source-backed explanation of a phone-numbering topic, suitable for answering end users.
is_scam_area_code
Explain whether an area code is associated with scams. An area code is never a scam by itself; this returns that context plus spoofing notes — caller ID can be faked, so judge calls by what they ask for, not the area code.
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_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.
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.

Public scan report

scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it

no findings

Code scan2 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 96 days ago8/15
Maintainer identityregistry namespace matches repository owner7/10

Overall 80/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How AreaCode.fyi MCP Server compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 80/100; higher than 60% of 48,255 servers
Tools: 8; the typical server has 7
Tools that change things: 0%; typical: 0%. Fewer write tools means less an agent can break
Downloads a week: 45; more than 37% of 12,191 servers with a package

What its tools let an agent do: 8 read

Install AreaCode.fyi MCP Server in Claude Code, Cursor or VS Code

Runs npx -y @riv-lc/areacode-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add areacode-mcp -- npx -y @riv-lc/areacode-mcp

Add to Cursor

What the publisher says

From the AreaCode.fyi MCP Server repository's README, as published. We do not edit it. Read it on GitHub

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 (claudedesktopconfig.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

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

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, canonicalurl, and datadate so answers can cite where the data came from.

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

AreaCode.fyi MCP Server: common questions

Is AreaCode.fyi MCP Server safe?: Mostly: it is graded B (80/100). Read the AreaCode.fyi MCP Server safety report
How do I install AreaCode.fyi MCP Server?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does AreaCode.fyi MCP Server need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is AreaCode.fyi MCP Server maintained?: The last commit was 135 days ago (2026-06-22). The latest release is v0.2.2.
How does AreaCode.fyi MCP Server compare with other MCP servers?: safety score 80/100 (higher than 60% of 48,255 servers); tools 8 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.