English Français العربية

AreaCode.fyi MCP Server

Registre officiel Outils de développement

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @riv-lc/areacode-mcp
Claude Code 
claude mcp add areacode-fyi-mcp-server -- npx -y @riv-lc/areacode-mcp@0.2.2
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "areacode-fyi-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@riv-lc/areacode-mcp@0.2.2"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. areacode-mcp
  2. Install
  3. Tools
  4. Example prompts
  5. Configuration
  6. Data & sourcing
  7. License

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

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.

Questions fréquentes

Qu'est-ce que AreaCode.fyi MCP Server ?

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

Comment installer AreaCode.fyi MCP Server ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add areacode-fyi-mcp-server -- npx -y @riv-lc/areacode-mcp@0.2.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour AreaCode.fyi MCP Server ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

AreaCode.fyi MCP Server est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient AreaCode.fyi MCP Server ?

Il est publié par riv-lc. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.