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 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
| Archivo | Qué es |
|---|---|
skills/pontofato/SKILL.md | La skill: qué herramienta responde qué pregunta, los límites de los datos y las reglas para llamadas de pago |
.mcp.json | El servidor MCP remoto del plugin |
.claude-plugin/plugin.json | El manifiesto del plugin |
.claude-plugin/marketplace.json | Permite que Claude Code agregue este repositorio como un marketplace de plugins |
server.json | El manifiesto en el registro oficial de MCP (com.pontofato/pontofato) |
glama.json | El 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.