areacode.fyi MCP server

North American area-code & phone-number intelligence for AI agents. An MCP server that gives Claude, Cursor, and other agents trusted lookups, carrier and scam-signal tools, and source-backed explainers — backed by the official NANPA data behind areacode.fyi.

Install (local, via npx)

For Claude Desktop / Cursor — add to your MCP client config, then restart:

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

Remote connector (ChatGPT, Claude.ai, web clients)

No install — add the hosted server URL https://mcp.areacode.fyi/mcp (legacy SSE: https://mcp.areacode.fyi/sse). Same 8 tools, no key.

Tools

  • lookup_area_code, lookup_phone_number, lookup_carrier
  • area_codes_for_city, area_codes_for_state
  • is_scam_area_code, check_number_reputation, explain_area_code_topic

Area-code-level reference for agents — not caller identity or live carrier. Configurable host via AREACODE_API_BASE.

npm · GitHub · the underlying API

Frequently asked questions

What is the areacode.fyi MCP server?

An MCP (Model Context Protocol) server that gives AI agents like Claude and Cursor a small, trusted set of tools for US & Canada phone numbering — look up an area code or number, find codes for a city or state, check a number's carrier or community signal, and get source-backed explainers. It wraps the areacode.fyi API.

How do I add it to Claude Desktop or Cursor?

Add it to your client's MCP config as an npx command: { "mcpServers": { "areacode": { "command": "npx", "args": ["-y", "@riv-lc/areacode-mcp"] } } }. Restart the client and the tools are available — no install or key needed.

Is the MCP server free?

Yes — it's open-source (MIT) and free, and the API it calls needs no key. Install with npx @riv-lc/areacode-mcp.

What can't the MCP do?

It is area-code-level reference, not a carrier-grade identity service: no caller identity, no exact location, and carrier is assigned-block (not live/ported). Caller ID can be spoofed, so an area code never proves who is calling.

Sourced from the official NANPA (North American Numbering Plan Administrator) numbering database, current as of August 2, 2026. Refreshed monthly.