AreaCode.fyi MCP Server

Inteligencia de códigos de área y números telefónicos de Norteamérica (NANP) para agentes de IA.

Documentación

areacode-mcp

Inteligencia de códigos de área y números de teléfono de América del Norte (NANP) para agentes de IA.

Un servidor MCP que ofrece a Claude, Cursor y otros agentes una referencia pequeña y confiable para la numeración telefónica de EE. UU. y Canadá: códigos de área, validación NANP, hora local, cobertura de ciudad/estado, superposiciones (overlays) y contexto de estafas/suplantación. Respaldado por areacode.fyi, que publica directamente desde la base de datos oficial de numeración NANPA. Cada resultado incluye una URL canónica areacode.fyi y la fecha de la fuente.

Alcance. Esto es referencia y educación a nivel de código de área, no una API de operador/identidad. No devuelve la identidad de la persona que llama, su ubicación exacta ni el operador en vivo/portado, y el identificador de llamadas puede ser suplantado, por lo que el código de área de un número nunca prueba quién llama. Para la identidad de la persona que llama necesitas un proveedor de grado operador (LRN/HLR).

Instalación

Ejecútalo con npx (no se necesita instalación) — agrégalo a la configuración MCP de tu cliente.

Claude Desktop (claude_desktop_config.json) / Cursor (~/.cursor/mcp.json):

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

Eso es todo: reinicia tu cliente y las herramientas siguientes estarán disponibles.

Publicado en el registro oficial de MCP como io.github.riv-lc/areacode-mcp, y en npm.

Remoto (alojado) — para ChatGPT, Claude.ai y clientes web

Sin instalación. Agrega el servidor alojado como URL de conector: las mismas 8 herramientas, sin clave:

https://mcp.areacode.fyi/mcp

(clientes SSE heredados: https://mcp.areacode.fyi/sse)

Herramientas

Herramienta	Qué hace
`lookup_area_code`	País, estado/provincia, ciudades, zona horaria, hora local actual, superposiciones, códigos cercanos
`lookup_phone_number`	Analizar/validar un número NANP → código de área, región, hora local, E.164
`lookup_carrier`	Operador asignado, tipo de línea (inalámbrica/fija) y centro de tarifa para el bloque NPA-NXX de un número (datos de asignación de bloques, no en vivo/portado; cubre casi todos los códigos de EE. UU./Canadá)
`area_codes_for_city`	Códigos de área que sirven a una ciudad (opcionalmente desambiguados por estado)
`area_codes_for_state`	Todos los códigos de área en un estado de EE. UU. o provincia canadiense
`is_scam_area_code`	Contexto de estafa/suplantación para un código de área + un agregado de quejas FTC Do Not Call presentadas sobre números que usan ese código
`check_number_reputation`	Señal comunitaria no verificada (baja / media / alta) más datos públicos de quejas FTC Do Not Call (recuento, % de robocalls, tema principal) para un número
`explain_area_code_topic`	Explicaciones respaldadas por fuentes: suplantación de vecino, superposiciones vs divisiones, números gratuitos, código de área vs código de país, números temporales

Ejemplos de indicaciones

"Un cliente potencial ingresó el número de teléfono +1 702-555-0199. ¿Dónde es probable que se encuentre y qué hora es allí?"
"Recibí una llamada del 469: ¿ese código de área es sospechoso?"
"¿Qué códigos de área cubren Las Vegas?"
"Normaliza esta lista de números de EE. UU./Canadá y marca los que sean inválidos o gratuitos."
"Explica la suplantación de vecino para un artículo del centro de ayuda."

Configuración

Variable de entorno	Predeterminado	Propósito
`AREACODE_API_BASE`	`https://areacode.fyi`	Apunta a un host diferente (por ejemplo, una API autoalojada o de prueba)

Datos y fuentes

Las herramientas llaman a la API JSON pública https://areacode.fyi/api/v1, que lee el mismo conjunto de datos que el sitio muestra, con fuente en la base de datos oficial del Administrador del Plan de Numeración de América del Norte (NANPA) y se actualiza mensualmente. Cada respuesta incluye source, canonical_url y data_date para que las respuestas puedan citar de dónde provienen los datos.

La señal check_number_reputation es no verificada y de origen comunitario (low = personas buscaron el número; mid/high = tiene informes de usuarios). Nunca es prueba de que un número específico sea fraudulento.