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.
LABSCO SUMMARY
A tool named is_scam_area_code that answers 'an area code is never the answer' is doing something unusually honest.
The demand is obviously there — people want a yes or no on whether a given code means fraud — and the easy product returns yes. Refusing the premise while still explaining what is actually associated with the code is a harder and better answer, and it prevents an agent from confidently telling someone a legitimate caller is a scammer. Labelling the reputation signal as unverified crowd-sourced data does the same job for the number-level question. The carrier and rate-centre lookup is the substantive reference half, and line type in particular is the fact that decides whether a number can receive a text.
What it is
A North American Numbering Plan reference client covering area codes, number parsing, carrier lookup and spam signals, with source-backed explanations of numbering topics.
What you get
- is_scam_area_code explains whether an area code is associated with scams and states plainly that an area code is never itself the answer — the tool refuses the framing its own name invites.
- check_number_reputation returns a crowd-sourced spam signal explicitly labelled unverified, rather than presented as fact.
- lookup_carrier returns the carrier, whether the line is wireless or landline, and the rate centre.
- lookup_phone_number parses and validates a NANP number and says whether the format is right.
- Area codes reachable from either direction — look one up for its country, state and principal cities, or list the codes serving a given city or an entire state or province.
- explain_area_code_topic returns source-backed explanations of numbering questions.
Requirements
Nothing to supply.
Setup effort
One command — npx -y @riv-lc/areacode-mcp
USE CASES
01
Working out who is calling
Look up the carrier, line type and rate centre for the number rather than inferring anything from the area code.
02
Checking whether a number is suspicious
Read the reputation signal knowing it is unverified crowd data, and the area-code explanation which will not condemn a code wholesale.
03
Finding out where a code covers
Look up the code for its country, state and principal cities, or go the other way from a city or state to the codes serving it.
04
Answering a numbering question properly
Get the source-backed explanation rather than a plausible summary.
8 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
area_codes_for_state
List every area code in a US state or Canadian province.
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.
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).
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.
BEFORE YOU INSTALL
What to know first
Tools you get
8 tools when we connected.
Requires
npx on PATH
CONTEXT COST
Light Standing cost
Rated by the size of the 8 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"areacode-mcp": {
"command": "npx",
"args": [
"-y",
"@riv-lc/areacode-mcp"
]
}
}
}npx
TERMINAL
npx -y @riv-lc/areacode-mcp
