Advertise
MCP.so
Sign In

Areacode.fyi MCP Server

@riv-lc

Repository

Basic information

Category

Other

Transports

stdio

Author

riv-lc

Submitted by

Lucas Czekaj

About Areacode.fyi MCP Server

North American NANP area-code and phone-number intelligence for AI agents: area-code lookup, NANP validation, local time, city/state/province coverage, overlays, scam/spoofing context, and block-allocation carrier metadata backed by areacode.fyi.

#mcp#area-code#nanp#phone-number#telephony#osint#caller-id#scam#areacode-fyi

Areacode.fyi MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

Areacode.fyi MCP Server tools

8

Look up a North American (NANP) area code: country, state/province, principal city and served cities, time zone, current local time, 10-digit-dialing flag, overlay codes, and nearby codes. Returns a canonical areacode.fyi URL and the NANPA source date.

Parse and validate a US/Canada (NANP) phone number. Returns whether the format is valid, the E.164 form, the area code, the likely region and time zone, and the current local time there. Area-code level only — NOT the caller's identity, exact location, or live carrier; caller ID can be spoofed.

Look up the carrier, line type (wireless/landline), and rate center that a US/Canada number's NPA-NXX block was assigned to — covering nearly every active area code. Based on public block-allocation data, NOT a live lookup: if the number was ported the current carrier differs. Not for caller identity, fraud, or FCRA decisions.

List the area codes that serve a US or Canadian city. Optionally pass a state/province to disambiguate cities that share a name.

List every area code in a US state or Canadian province.

Explain whether an area code is associated with scams. An area code is never a scam by itself; returns that context + spoofing notes, PLUS an aggregate of public FTC Do Not Call complaints about specific numbers shown with that code (how many flagged numbers, total complaints, top subjects, worst offenders).

Spam signal for a US/Canada number from areacode.fyi: the UNVERIFIED crowd-sourced community signal ('low' = looked up, 'mid'/'high' = user reports) PLUS public FTC Do Not Call complaint data when present (complaint count, % robocalls, top subject, date range). Caller ID can be spoofed — none of this proves a number is currently fraudulent.

Source-backed explanation of a phone-numbering topic, suitable for answering end users.

Overview

What is Areacode.fyi MCP Server?

An MCP server that provides North American (NANP) area‑code and phone‑number intelligence to AI agents. It offers a trusted reference for US and Canada phone numbering — including area codes, NANP validation, local time, city/state coverage, overlays, and scam/spoofing context. Backed by the areacode.fyi website, which publishes directly from the official NANPA numbering database.

How to use Areacode.fyi MCP Server?

Configure the server as an MCP tool in agent platforms such as Claude or Cursor. It calls the public areacode.fyi JSON API to fetch data. No installation steps beyond standard MCP server setup are described in the README.

Key features of Areacode.fyi MCP Server

  • North American area‑code lookup for US & Canada
  • NANP phone‑number validation
  • Local time retrieval for any area code
  • City and state coverage information
  • Overlay area‑code detection
  • Scam and spoofing context

Use cases of Areacode.fyi MCP Server

  • Validate a phone number’s NANP format during customer intake
  • Look up the local time of an area code for scheduling
  • Identify city/state coverage for a given area code
  • Check whether an area code has overlays or is associated with scams
  • Generate cited area‑code answers with canonical source URLs

Frequently asked questions

1

What area codes does the server cover?

It covers all North American Numbering Plan (NANP) area codes for the United States and Canada.

2

Where does the data come from?

The data is sourced from the official North American Numbering Plan Administrator (NANPA) database and is refreshed monthly.

3

How does an agent access the areacode.fyi data?

The MCP server’s tools call the public areacode.fyi API (https://areacode.fyi/api/v1), which returns the same dataset used by the website.

4

Does each response include a source citation?

Yes. Every response carries a `canonical_url`, `source`, and `data_date` field so answers can cite where the data came from.

5

Is the API public and free to use?

The README describes the API as public, but does not explicitly state pricing or usage limits.

Comments

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K
N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

Advertise