PontoFato

Direcciones brasileñas para agentes: puntos CEP geocodificados por IBGE, búsqueda por radio y empresas por CEP.

Servidor MCP alojado

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

Se instala en Claude Code, Codex, Cursor y más

Documentación

PontoFato — skill y servidor MCP para agentes de IA

PontoFato

PontoFato permite que un agente de IA encuentre direcciones brasileñas y las empresas a su alrededor. Un código postal (CEP) devuelve sus direcciones con las coordenadas del Censo IBGE 2022 (CNEFE), los datos del sector censal de cada edificio y las empresas registradas allí. El agente también puede buscar una calle, encontrar la dirección más cercana a un punto y contar las empresas de una actividad en un radio de 2 km. Este repositorio empaqueta la skill de PontoFato y la conexión a su servidor MCP remoto para Claude Code, Codex, Cursor y otros agentes.

Sitio: https://pontofato.com · Servidor MCP: https://pontofato.com/mcp?checkout=site · Precios: https://pontofato.com/pricing · Documentación de la API: https://pontofato.com/developers

Lo que tu agente puede hacer

  • Consultar un CEP: direcciones, latitud y longitud, y los datos del sector censal (personas, hogares e ingresos) de cada edificio.
  • Buscar una calle por nombre, en un estado o ciudad, y listar las unidades (apartamentos, tiendas) de un edificio.
  • Encontrar la dirección más cercana a una coordenada y los CEPs dentro de un radio de hasta 2 km.
  • Listar las empresas registradas en un CEP.
  • Contar empresas activas, abiertas y cerradas de una actividad (CNAE) alrededor de un punto, con las aperturas más recientes.

Prueba: "¿Qué restaurantes abrieron cerca del CEP 01310-100 en los últimos meses?" o "Encuentra las coordenadas de Avenida Paulista, 1000, São Paulo."

Instalación

Claude Code, como plugin con la skill y el servidor MCP:

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

Cualquier agente que lea Agent Skills (Claude Code, Codex, Cursor, OpenCode y otros):

npx skills add wrpbr/pontofato

Solo el servidor MCP (remoto, Streamable HTTP, sin clave para las herramientas 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" } } }

El JSON anterior va en .cursor/mcp.json para Cursor y en la configuración de MCP de la mayoría de los otros clientes. En Claude.ai y Claude Desktop, abre Configuración → Conectores → Agregar conector personalizado y pega la dirección del servidor.

Precio

La consulta de CEP, la búsqueda de calles, la dirección más cercana, el radio y las empresas de un CEP son gratuitas y no requieren clave. El conteo de empresas alrededor de un punto (vizinhanca) tiene su propia cuota; el índice de la API indica cuándo es gratuito. La verificación completa de CNPJ y dirección ofrece una cuota gratuita diaria; después, la verificación usa un paquete o un plan. Compras planes y crédito prepago en el sitio, y los planes no se renuevan automáticamente. El plugin nunca paga: con checkout=site, el servidor MCP no tiene herramienta de compra ni argumento de pago. El agente muestra el precio y el enlace, y después de tu compra usa tu token de crédito. Los precios actuales están en https://pontofato.com/pricing.

Lo que envía el plugin

La skill le indica al agente llamar a la API de PontoFato en pontofato.com. El servidor MCP también se ejecuta en pontofato.com. Tus consultas (CEPs, nombres de calles, coordenadas y códigos de actividad) van a pontofato.com a través de HTTPS. Un token de crédito se envía solo cuando lo proporcionas para una llamada de pago. El plugin no ejecuta ningún programa local ni lee ningún archivo local.

Datos y límites

Las direcciones provienen del CNEFE del IBGE del Censo 2022. No prueban que un CEP o una dirección sea válido hoy. Las empresas provienen del volcado público de CNPJ de la Receita Federal y se emparejan con direcciones por CEP, por lo que la distancia de una empresa es una distancia de CEP, no del edificio exacto.

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.

Archivos

ArchivoQué es
skills/pontofato/SKILL.mdLa skill: qué herramienta responde qué pregunta, los límites de los datos y las reglas para llamadas de pago
.mcp.jsonEl servidor MCP remoto del plugin
.claude-plugin/plugin.jsonEl manifiesto del plugin
.claude-plugin/marketplace.jsonPermite que Claude Code agregue este repositorio como un marketplace de plugins
server.jsonEl manifiesto en el registro oficial de MCP (com.pontofato/pontofato)
glama.jsonEl mantenedor para el directorio MCP de Glama

Licencia y contacto

Los archivos de este repositorio están bajo la licencia MIT-0. El servicio PontoFato y sus datos no forman parte de esta licencia: su uso sigue los términos de uso y la política de privacidad. Para preguntas o problemas, abre un issue aquí o escribe a contato@pontofato.com.