PontoFato

npx add-mcp 'https://pontofato.com/mcp'

PontoFato — skill e servidor MCP para agentes de IA

O PontoFato permite que um agente de IA encontre endereços brasileiros e as empresas ao redor deles. Um CEP retorna seus endereços com as coordenadas do Censo IBGE 2022 (CNEFE), os dados do setor censitário de cada prédio e as empresas registradas ali. O agente também pode buscar uma rua, encontrar o endereço mais próximo de um ponto e contar as empresas de uma atividade num raio de 2 km. Este repositório empacota a skill do PontoFato e a conexão com seu servidor MCP remoto para Claude Code, Codex, Cursor e outros agentes.

Site: https://pontofato.com · Servidor MCP: https://pontofato.com/mcp?checkout=site · Preços: https://pontofato.com/pricing · Documentação da API: https://pontofato.com/developers

O que seu agente pode fazer

• Consultar um CEP: endereços, latitude e longitude, e os dados do setor censitário (pessoas, domicílios e renda) de cada prédio.
• Buscar uma rua pelo nome, em um estado ou cidade, e listar as unidades (apartamentos, lojas) de um prédio.
• Encontrar o endereço mais próximo de uma coordenada e os CEPs num raio de até 2 km.
• Listar as empresas registradas em um CEP.
• Contar empresas ativas, abertas e fechadas de uma atividade (CNAE) ao redor de um ponto, com as aberturas mais recentes.

Experimente: "Quais restaurantes abriram perto do CEP 01310-100 nos últimos meses?" ou "Encontre as coordenadas da Avenida Paulista, 1000, São Paulo."

Instalação

Claude Code, como plugin com a skill e o servidor MCP:

/plugin marketplace add wrpbr/pontofato
/plugin install pontofato@pontofato

Qualquer agente que leia Agent Skills (Claude Code, Codex, Cursor, OpenCode e outros):

npx skills add wrpbr/pontofato

Somente o servidor MCP (remoto, Streamable HTTP, sem chave para as ferramentas gratuitas):

claude mcp add --transport http pontofato 'https://pontofato.com/mcp?checkout=site'   # Claude Code
codex mcp add pontofato --url 'https://pontofato.com/mcp?checkout=site'               # Codex

{ "mcpServers": { "pontofato": { "url": "https://pontofato.com/mcp?checkout=site" } } }

O JSON acima vai em .cursor/mcp.json para o Cursor e nas configurações de MCP da maioria dos outros clientes. No Claude.ai e no Claude Desktop, abra Configurações → Conectores → Adicionar conector personalizado e cole o endereço do servidor.

Preço

A consulta de CEP, a busca de rua, o endereço mais próximo, o raio e as empresas de um CEP são gratuitos e não precisam de chave. A contagem de empresas ao redor de um ponto (vizinhanca) tem sua própria cota; o índice da API informa quando é gratuita. A verificação completa de CNPJ e endereço dá uma cota gratuita por dia; depois dela, a verificação usa um pacote ou um plano. Você compra planos e crédito pré-pago no site, e os planos não renovam automaticamente. O plugin nunca paga: com checkout=site, o servidor MCP não tem ferramenta de compra nem argumento de pagamento. O agente mostra o preço e o link, e após sua compra ele usa seu token de crédito. Os preços atuais estão em https://pontofato.com/pricing.

O que o plugin envia

A skill instrui o agente a chamar a API do PontoFato em pontofato.com. O servidor MCP também roda em pontofato.com. Suas consultas (CEPs, nomes de ruas, coordenadas e códigos de atividade) vão para pontofato.com via HTTPS. Um token de crédito vai somente quando você fornece um para uma chamada paga. O plugin não executa nenhum programa local e não lê nenhum arquivo local.

Dados e limites

Os endereços vêm do CNEFE do IBGE do Censo 2022. Eles não comprovam que um CEP ou endereço é válido hoje. As empresas vêm do dump público de CNPJ da Receita Federal e são associadas aos endereços por CEP, então a distância de uma empresa é uma distância de CEP, não do prédio exato.

Em português

O PontoFato deixa o agente de IA achar endereços brasileiros e as empresas em volta. O CEP traz os endereços com a coordenada do IBGE (CNEFE 2022), os dados do setor do Censo de cada prédio e as empresas registradas nele. O agente também busca rua, acha o endereço mais próximo de um ponto e conta as empresas de uma atividade num raio de até 2 km. Este repositório traz a skill e a conexão com o servidor MCP remoto. Instale com os comandos acima. A consulta de CEP é grátis e não pede chave. A compra é sempre no site, e o plugin nunca paga sozinho. Os preços estão em https://pontofato.com/pricing.

Arquivos

Arquivo	O que é
skills/pontofato/SKILL.md	A skill: qual ferramenta responde a qual pergunta, os limites dos dados e as regras para chamadas pagas
.mcp.json	O servidor MCP remoto do plugin
.claude-plugin/plugin.json	O manifesto do plugin
.claude-plugin/marketplace.json	Permite que o Claude Code adicione este repositório como um marketplace de plugins
server.json	O manifesto no registro oficial de MCP (com.pontofato/pontofato)
glama.json	O mantenedor para o diretório MCP da Glama

Licença e contato

Os arquivos deste repositório estão sob a licença MIT-0. O serviço PontoFato e seus dados não fazem parte desta licença: seu uso segue os termos de uso e a política de privacidade. Para dúvidas ou problemas, abra uma issue aqui ou escreva para contato@pontofato.com.