PontoFato — навык и MCP-сервер для AI-агентов
PontoFato помогает AI-агентам находить адреса в Бразилии и компании поблизости. По почтовому индексу (CEP) сервис возвращает адреса с координатами из переписи IBGE 2022 года (CNEFE), данные переписного участка для каждого здания и зарегистрированные по этим адресам компании. Агент также может искать улицу, находить ближайший к точке адрес и подсчитывать количество компаний определённого вида деятельности в радиусе 2 км. В этом репозитории собраны навык PontoFato и подключение к удалённому MCP-серверу для Claude Code, Codex, Cursor и других агентов.
Сайт: https://pontofato.com · MCP-сервер: https://pontofato.com/mcp?checkout=site · Цены: https://pontofato.com/pricing ·
Документация API: https://pontofato.com/developers
Что умеет агент
-
Находить данные по CEP: адреса, широту и долготу, а также сведения о переписном участке для каждого здания — численность населения, количество жилых помещений и доходы.
-
Искать улицу по названию в штате или городе и перечислять помещения в здании: квартиры, магазины и другие.
-
Находить ближайший к координатам адрес и CEP в радиусе до 2 км.
-
Перечислять компании, зарегистрированные по CEP.
-
Подсчитывать количество действующих, недавно открывшихся и закрывшихся компаний определённого вида деятельности (CNAE) рядом с точкой, включая самые свежие открытия.
Например: «Какие рестораны открылись рядом с CEP 01310-100 за последние месяцы?» или
«Найди координаты Avenida Paulista, 1000, São Paulo».
Установка
Claude Code — плагин с навыком и MCP-сервером:
/plugin marketplace add wrpbr/pontofato
/plugin install pontofato@pontofato
Для любого агента, который поддерживает Agent Skills (Claude Code, Codex, Cursor, OpenCode и другие):
npx skills add wrpbr/pontofato
Только MCP-сервер — удалённый, Streamable HTTP; для бесплатных инструментов ключ не нужен:
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" } } }
Приведённый выше JSON нужно добавить в .cursor/mcp.json в Cursor, а в большинстве других клиентов — в настройки MCP. В Claude.ai и
Claude Desktop откройте Settings → Connectors → Add custom connector и вставьте адрес сервера.
Стоимость
Поиск по CEP и улице, поиск ближайшего адреса, поиск в радиусе и получение списка компаний по CEP бесплатны и не требуют ключа. Для подсчёта компаний рядом с точкой (vizinhanca) предусмотрена отдельная квота; в каталоге API указано, когда эта функция бесплатна. Проверка полных данных CNPJ и адреса доступна бесплатно в пределах ежедневной квоты; после её исчерпания проверка оплачивается пакетами или по тарифному плану. Тарифные планы и предоплаченный баланс можно приобрести на сайте; автоматического продления у планов нет. Плагин не совершает оплату: при checkout=site у MCP-сервера нет инструмента покупки и параметра для оплаты. Агент показывает цену и ссылку, а после покупки использует ваш токен с балансом. Актуальные цены опубликованы на странице https://pontofato.com/pricing.
Какие данные отправляет плагин
Навык указывает агенту обращаться к API PontoFato на pontofato.com. MCP-сервер также работает на pontofato.com.
Ваши запросы — CEP, названия улиц, координаты и коды видов деятельности — передаются на pontofato.com по HTTPS. Токен с балансом отправляется только в том случае, если вы предоставили его для платного запроса. Плагин не запускает локальные программы и не читает локальные файлы.
Данные и ограничения
Адреса взяты из CNEFE IBGE — переписи 2022 года. Эти данные не подтверждают, что CEP или адрес действителен в настоящее время.
Данные о компаниях получены из открытой выгрузки CNPJ Федеральной налоговой службы и сопоставлены с адресами по CEP. Поэтому расстояние до компании рассчитывается по CEP, а не до конкретного здания.
Кратко о сервисе
PontoFato помогает AI-агенту находить адреса в Бразилии и компании поблизости. По CEP можно получить адреса с координатами IBGE (CNEFE 2022), данные переписного участка для каждого здания и сведения о зарегистрированных по этим адресам компаниях. Агент также может искать улицы, находить ближайший к точке адрес и подсчитывать количество компаний определённого вида деятельности в радиусе до 2 км. В этом репозитории собраны навык и подключение к удалённому MCP-серверу. Для установки используйте команды выше. Поиск по CEP бесплатен и не требует ключа. Покупки совершаются только на сайте, плагин никогда не оплачивает их самостоятельно. Цены указаны на странице https://pontofato.com/pricing.
Файлы
| Файл | Описание |
|---|---|
skills/pontofato/SKILL.md | Навык: какой инструмент отвечает на тот или иной вопрос, каковы ограничения данных и правила платных запросов |
.mcp.json | Удалённый MCP-сервер плагина |
.claude-plugin/plugin.json | Манифест плагина |
.claude-plugin/marketplace.json | Позволяет добавить этот репозиторий в маркетплейс плагинов Claude Code |
server.json | Манифест в официальном реестре MCP (com.pontofato/pontofato) |
glama.json | Информация о сопровождающем для каталога Glama MCP |
Лицензия и контакты
На файлы в этом репозитории распространяется лицензия MIT-0. На сервис PontoFato и его данные эта лицензия не распространяется: их использование регулируется условиями использования и политикой конфиденциальности. Если у вас есть вопросы или возникли проблемы, создайте issue в этом репозитории или напишите на contato@pontofato.com.