API ВЕГА
English

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.