@riv Lc/areacode

GitHub Actions

North American (NANP) area-code & phone-number intelligence for AI agents — an MCP server backed by areacode.fyi.

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "riv-lc-areacode-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "@riv-lc/[email protected]"8      ]9    }10  }11}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @riv-lc/[email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add riv-lc-areacode-mcp -- npx -y @riv-lc/areacode-mcp@0.2.3

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "riv-lc-areacode-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "@riv-lc/[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.2.3
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install @riv Lc/areacode?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does @riv Lc/areacode need an API key?

No required environment variable is listed on this record.

What transport does @riv Lc/areacode use?

@riv Lc/areacode runs locally over stdio.

When was @riv Lc/areacode last checked?

Last checked 2026-10-28. North American (NANP) area-code & phone-number intelligence for AI agents — an MCP server backed by areacode.fyi.

From the publisher

Documentation

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

Tool	What it does
`lookup_area_code`	Country, state/province, cities, time zone, current local time, overlays, nearby codes
`lookup_phone_number`	Parse/validate a NANP number → area code, region, local time, E.164
`lookup_carrier`	Assigned 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_city`	Area codes serving a city (optionally disambiguated by state)
`area_codes_for_state`	Every area code in a US state or Canadian province
`is_scam_area_code`	Scam/spoofing context for an area code + an aggregate of FTC Do Not Call complaints filed about numbers using that code
`check_number_reputation`	Unverified community signal (low / mid / high) plus public FTC Do Not Call complaint data (count, % robocalls, top subject) for a number
`explain_area_code_topic`	Source-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 var	Default	Purpose
`AREACODE_API_BASE`	`https://areacode.fyi`	Point 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.

@riv Lc/areacode

GitHub Actions

North American (NANP) area-code & phone-number intelligence for AI agents — an MCP server backed by areacode.fyi.

Devops Developer Tools

Add to Cursor Add to VS Code Run on PlugMCP

GitHub npm Website

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "riv-lc-areacode-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "@riv-lc/[email protected]"8      ]9    }10  }11}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @riv-lc/[email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add riv-lc-areacode-mcp -- npx -y @riv-lc/areacode-mcp@0.2.3

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "riv-lc-areacode-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "@riv-lc/[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.2.3
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install @riv Lc/areacode?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does @riv Lc/areacode need an API key?

No required environment variable is listed on this record.

What transport does @riv Lc/areacode use?

@riv Lc/areacode runs locally over stdio.

When was @riv Lc/areacode last checked?

Last checked 2026-10-28. North American (NANP) area-code & phone-number intelligence for AI agents — an MCP server backed by areacode.fyi.

From the publisher

Documentation

areacode-mcp

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

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

Tool	What it does
`lookup_area_code`	Country, state/province, cities, time zone, current local time, overlays, nearby codes
`lookup_phone_number`	Parse/validate a NANP number → area code, region, local time, E.164
`lookup_carrier`	Assigned 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_city`	Area codes serving a city (optionally disambiguated by state)
`area_codes_for_state`	Every area code in a US state or Canadian province
`is_scam_area_code`	Scam/spoofing context for an area code + an aggregate of FTC Do Not Call complaints filed about numbers using that code
`check_number_reputation`	Unverified community signal (low / mid / high) plus public FTC Do Not Call complaint data (count, % robocalls, top subject) for a number
`explain_area_code_topic`	Source-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 var	Default	Purpose
`AREACODE_API_BASE`	`https://areacode.fyi`	Point at a different host (e.g. a self-hosted or staging API)