AreaCode.fyi MCP Server

Inteligência de códigos de área e números de telefone da NANP da América do Norte para agentes de IA.

Documentação

areacode-mcp

Inteligência de códigos de área e números de telefone da América do Norte (NANP) para agentes de IA.

Um servidor MCP que oferece a Claude, Cursor e outros agentes uma referência pequena e confiável para a numeração telefônica dos EUA e Canadá — códigos de área, validação NANP, horário local, cobertura de cidade/estado, sobreposições e contexto de golpes/falsificação. Com suporte de areacode.fyi, que publica diretamente do banco de dados oficial de numeração NANPA. Cada resultado inclui um URL canônico areacode.fyi e a data da fonte.

Escopo. Esta é uma referência e educação em nível de código de área — não uma API de operadora/identidade. Ela não retorna a identidade de quem liga, localização exata ou operadora ativa/portada, e o identificador de chamadas (caller ID) pode ser falsificado, então o código de área de um número nunca prova quem está ligando. Para identidade de quem liga, você precisa de um provedor de nível de operadora (LRN/HLR).

Instalação

Execute com npx (sem necessidade de instalação) — adicione-o à configuração MCP do seu cliente.

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

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

É isso — reinicie seu cliente e as ferramentas abaixo estarão disponíveis.

Publicado no Registro Oficial MCP como io.github.riv-lc/areacode-mcp, e no npm.

Remoto (hospedado) — para ChatGPT, Claude.ai e clientes web

Sem instalação. Adicione o servidor hospedado como URL de conector — as mesmas 8 ferramentas, sem chave:

https://mcp.areacode.fyi/mcp

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

Ferramentas

Ferramenta	O que faz
`lookup_area_code`	País, estado/província, cidades, fuso horário, horário local atual, sobreposições, códigos próximos
`lookup_phone_number`	Analisar/validar um número NANP → código de área, região, horário local, E.164
`lookup_carrier`	Operadora designada, tipo de linha (sem fio/fixa) e centro de tarifação para o bloco NPA-NXX de um número (dados de alocação de bloco, não ativos/portados; cobre quase todos os códigos dos EUA/Canadá)
`area_codes_for_city`	Códigos de área que atendem uma cidade (opcionalmente desambiguados por estado)
`area_codes_for_state`	Todos os códigos de área em um estado dos EUA ou província canadense
`is_scam_area_code`	Contexto de golpes/falsificação para um código de área + um agregado de reclamações FTC Do Not Call registradas sobre números que usam esse código
`check_number_reputation`	Sinal comunitário não verificado (baixo / médio / alto) mais dados públicos de reclamações FTC Do Not Call (contagem, % de robocalls, principal assunto) para um número
`explain_area_code_topic`	Explicações com base em fontes: falsificação de vizinho, sobreposições vs divisões, números gratuitos, código de área vs código de país, números temporários

Exemplos de prompts

"Um lead inseriu o número de telefone +1 702-555-0199. Onde ele provavelmente está localizado e que horas são lá?"
"Recebi uma ligação de 469 — esse código de área é suspeito?"
"Quais códigos de área cobrem Las Vegas?"
"Normalize esta lista de números dos EUA/Canadá e sinalize qualquer um que seja inválido ou gratuito."
"Explique a falsificação de vizinho para um artigo de central de ajuda."

Configuração

Variável de ambiente	Padrão	Finalidade
`AREACODE_API_BASE`	`https://areacode.fyi`	Apontar para um host diferente (ex.: uma API auto-hospedada ou de staging)

Dados e fontes

As ferramentas chamam a API JSON pública https://areacode.fyi/api/v1, que lê o mesmo conjunto de dados que o site renderiza — originado do banco de dados oficial da North American Numbering Plan Administrator (NANPA) e atualizado mensalmente. Cada resposta carrega source, canonical_url e data_date para que as respostas possam citar de onde os dados vieram.

O sinal check_number_reputation é não verificado e de crowdsourcing (low = pessoas pesquisaram o número; mid/high = tem relatos de usuários). Ele nunca é prova de que um número específico é fraudulento.