AreaCode.fyi MCP Server

io.github.riv-lc由 GitHub 账号 riv-lc 发布v0.2.2更新于 Oct 24, 2026

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

已验证STDIO仅桌面位置与生活网页搜索与抓取

概览

AI 生成的概览

为助手提供美国与加拿大电话号码参考的 MCP 服务器：区号、NANP 校验、当地时间、覆盖范围与诈骗背景信息。

可以做什么
查询区号对应的国家、州或省、城市、时区、当前当地时间、叠加区号与邻近区号，并解析或校验 NANP 号码，得到区号、地区、当地时间与 E.164 格式。查找某城市可用的区号，或某个美国州、加拿大省的全部区号。查询号码 NPA-NXX 段分配的运营商、线路类型与计费中心。获取区号的诈骗与伪造背景、FTC 谢绝来电投诉汇总，以及号码未经核实的社区信誉信号。阅读有来源的说明文章，如邻近号码伪造、叠加与拆分、免费电话及临时号码。
适用场景
适合助手处理美国或加拿大电话号码时使用：根据号码推断线索所在地、规范化并校验号码列表、回答某区号是否可疑，或撰写关于号码伪造与编号规则的帮助中心内容。
运行要求
通过 stdio 在本地运行，通常用 npx 调用 npm 包，也可作为托管连接器 URL 供网页客户端使用。无需账号、API 密钥或已声明的环境变量；可选的 AREACODE_API_BASE 变量用于指向其他主机。需要能访问 areacode.fyi 的 API。
安装前请注意
工具会把查询发送到公开的 areacode.fyi API，因此所查询的号码和区号会离开本机。结果仅为区号层面的参考：不提供来电者身份、精确位置或实时/携转运营商，区号不能证明来电者是谁。check_number_reputation 信号未经核实且来自众包，不能作为欺诈的证据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 AreaCode.fyi MCP Server，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

areacode-mcp

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

[smithery badge] [npm]

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):

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

ToolWhat it does
lookup_area_codeCountry, state/province, cities, time zone, current local time, overlays, nearby codes
lookup_phone_numberParse/validate a NANP number → area code, region, local time, E.164
lookup_carrierAssigned 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_cityArea codes serving a city (optionally disambiguated by state)
area_codes_for_stateEvery area code in a US state or Canadian province
is_scam_area_codeScam/spoofing context for an area code + an aggregate of FTC Do Not Call complaints filed about numbers using that code
check_number_reputationUnverified community signal (low / mid / high) plus public FTC Do Not Call complaint data (count, % robocalls, top subject) for a number
explain_area_code_topicSource-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 varDefaultPurpose
AREACODE_API_BASEhttps://areacode.fyiPoint 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.

来源：README.md，提交 a29994c

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分