Areacode.fyi Mcp Server

areacode-mcp

面向 AI Agent 的北美编号计划（NANP）区号与电话号码情报。

一个 MCP 服务，为 Claude、Cursor 和 其他 Agent 提供一份精简、可信的美国和加拿大电话号码编号参考，涵盖区号、 NANP 验证、本地时间、城市/州覆盖范围、叠加区号，以及 诈骗/号码伪装相关信息。数据由 areacode.fyi 支持，该网站 直接从官方 NANPA 编号数据库发布数据。每项结果都包含规范的 areacode.fyi URL 和数据来源日期。

范围。 本服务提供区号层面的参考信息和科普内容，不是 运营商/身份 API。它不会返回来电者身份、精确 位置或实时/携号转网后的运营商信息；来电显示也可以伪造，因此电话号码的 区号绝不能证明来电者是谁。要查询来电者身份，需要使用 运营商级（LRN/HLR）服务提供商。

安装

使用 npx 运行（无需安装）——将其添加到客户端的 MCP 配置中。

Claude Desktop（claude_desktop_config.json）/ Cursor（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "areacode": {
      "command": "npx",
      "args": ["-y", "@riv-lc/areacode-mcp"]
    }
  }
}

就这么简单——重启客户端后，即可使用下方的工具。

已发布到官方 MCP Registry，名称为 io.github.riv-lc/areacode-mcp，并 发布到 npm。

远程（托管）——适用于 ChatGPT、Claude.ai 和网页客户端

无需安装。将托管服务添加为连接器 URL——提供相同的 8 个工具，无需密钥：

https://mcp.areacode.fyi/mcp

（旧版 SSE 客户端：https://mcp.areacode.fyi/sse）

工具

工具	功能
lookup_area_code	国家、州/省、城市、时区、当前当地时间、叠加区号、邻近区号
lookup_phone_number	解析/验证 NANP 电话号码 → 区号、地区、当地时间、E.164
lookup_carrier	查询号码 NPA-NXX 区段的指定运营商、线路类型（无线/固定电话）和费率中心（区段分配数据，非实时/携号转网数据；覆盖几乎所有美国/加拿大区号）
area_codes_for_city	查询服务于某座城市的区号（可选择按州消除歧义）
area_codes_for_state	查询美国某州或加拿大某省的所有区号
is_scam_area_code	查询某区号相关的诈骗/号码伪装信息，以及使用该区号的号码收到的 FTC 请勿来电投诉汇总数据
check_number_reputation	未经验证的社区信号（低 / 中 / 高），加上公开的 FTC 请勿来电投诉数据（数量、自动语音电话占比、主要投诉主题）
explain_area_code_topic	基于来源的说明：邻近区号伪装、叠加区号与拆分、免费电话、区号与国家代码的区别、临时号码

示例提示词

• “有潜在客户填写了电话号码 +1 702-555-0199。他们可能在哪里？当地现在几点？”
• “我接到了来自 469 的电话——这个区号可疑吗？”
• “拉斯维加斯有哪些区号？”
• “规范化这份美国/加拿大电话号码列表，并标出无效号码或免费电话号码。”
• “为帮助中心文章解释邻近区号伪装。”

配置

环境变量	默认值	用途
AREACODE_API_BASE	https://areacode.fyi	指向其他主机（例如可自托管或用于预发布的 API）

数据与来源

工具会调用公开的 https://areacode.fyi/api/v1 JSON API，该 API 读取 与网站展示相同的数据集——数据来源为官方的北美编号计划管理机构（NANPA） 数据库，并每月刷新一次。每个响应都包含 source、canonical_url 和 data_date，便于回答时注明 数据来源。

check_number_reputation 信号未经验证，且由用户共同提供 （low = 有人查询过该号码；mid/high = 该号码有用户举报）。它 绝不能作为某个特定号码存在欺诈行为的证据。

License

MIT © Reindex Ventures. Built for areacode.fyi.