English Français العربية

AreaCode.fyi MCP Server

Official registry Developer tools

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  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.

Frequently asked questions

What is AreaCode.fyi MCP Server?

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

How do I install AreaCode.fyi MCP Server?

It runs on your machine. In Claude Code: claude mcp add areacode-fyi-mcp-server -- npx -y @riv-lc/areacode-mcp@0.2.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does AreaCode.fyi MCP Server need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is AreaCode.fyi MCP Server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains AreaCode.fyi MCP Server?

It is published by riv-lc. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.