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 分