Skip to main content
Glama

@apifreaks/mcp

npm version GitHub release Glama Node.js CI License

Официальный сервер Model Context Protocol (MCP) для APIFreaks. Добавьте его в Claude, Cursor, Windsurf или любой MCP-совместимый клиент, и ваш ИИ сможет мгновенно запрашивать живую погоду, домены, IP-адреса, DNS-записи, SSL-сертификаты, курсы валют, цены на сырьевые товары, скриншоты, PDF-файлы, веб-скрапинг, проверку VAT/IBAN/SWIFT, электронной почты и телефонов, геокодирование и многое другое.

Что можно спросить после подключения?

🌦

«Какой прогноз на 7 дней для Токио и стоит ли брать зонт?»

🔒

«Проверь SSL-сертификат stripe.com — действителен ли он и когда истекает?»

🌍

«Кто зарегистрировал openai.com и когда? Менялась ли запись WHOIS недавно?»

💱

«Конвертируй 2500 USD в EUR, GBP и JPY по сегодняшнему живому курсу.»

🔍

«Проверь, доступны ли эти 20 доменных имён для регистрации.»

📡

«Какие DNS-записи есть у github.com? Покажи полные записи MX и TXT.»


Содержание


Related MCP server: Weather MCP Server

Требования


Переменные окружения

Переменная

Обязательная

Описание

APIFREAKS_API_KEY

Да

Ваш API-ключ APIFreaks — получите его на apifreaks.com

APIFREAKS_MODULES

Да

Список модулей через запятую. Если не задан или пуст, будет доступен только list_modules (без API-инструментов). См. Модули.


Модули

Этот сервер охватывает множество API. Рекламировать все их в tools/list заполнило бы контекстное окно клиента, поэтому вы выбираете только те модули, которые вам действительно нужны.

Установите APIFREAKS_MODULES в конфигурации вашего MCP-клиента. Регистрируются только эти модули, поэтому tools/list возвращает только этот поднабор. Если переменная отсутствует или пуста, API-инструменты не отображаются — только list_modules. Вызовите его, чтобы увидеть каждый модуль и инструменты внутри него, затем вставьте полную строку APIFREAKS_MODULES=... (все нужные модули, а не только новое имя) и перезапустите.

APIFREAKS_MODULES=ip-intelligence,currency,whois,dns,weather

Дефисы и подчёркивания взаимозаменяемы (user-agent и user_agent работают одинаково). Неизвестные имена игнорируются и записываются в stderr.

Модуль

Инструменты

ip-intelligence

Геолокация IP и анализ угроз (одиночный + массовый)

geocoding

Прямое и обратное геокодирование

whois

Домен, IP, ASN, история, обратный поиск, массовый

dns

Живой поиск, история, обратный поиск, массовый

scraper

Скрапинг статического HTML и рендеринг JS

email-validation

Одиночная и массовая проверка электронной почты

phone-validation

Одиночная и массовая проверка телефонов

ssl

Живой сертификат и полная цепочка

domain

Проверка доступности, предложения, массовый, поиск поддоменов

screenshot

Захват, прокручиваемый захват, массовый

pdf

Объединение, разделение, сжатие, защита, создание, конвертация

currency

Живые/исторические курсы, конвертеры, временные ряды, символы, лимиты

commodity

Живые/исторические цены, колебания, временные ряды, символы

financial

Ставки VAT, номера VAT, IBAN, SWIFT/BIC

zipcode

Поиск, радиус, расстояние, город/регион

weather

Текущая погода, прогноз, история, качество воздуха, морская, наводнения, астрономия

geography

Административные единицы, страны, города, регионы, флаги

timezone

Поиск и конвертация

user-agent

Разбор одиночных или массовых строк user-agent


Получение API-ключа

Войдите или создайте бесплатную учётную запись на apifreaks.com. Ваш API-ключ находится в панели управления в разделе API Keys.

Полная документация API: apifreaks.com/docs


Быстрый старт

Самый быстрый способ подключения — через CLI Claude Code:

claude mcp add apifreaks -e APIFREAKS_API_KEY=your_apikey_here -e APIFREAKS_MODULES=ip-intelligence,currency,whois,dns,weather -- npx -y @apifreaks/mcp

Замените ip-intelligence,currency,whois,dns,weather на нужные вам модули. Для Cursor, Windsurf, Cline и других см. Руководства по интеграции ниже.


Руководства по интеграции

Claude Code

Через терминал (рекомендуется):

claude mcp add apifreaks -e APIFREAKS_API_KEY=your_apikey_here -e APIFREAKS_MODULES=ip-intelligence,currency,whois,dns,weather -- npx -y @apifreaks/mcp

Через файл конфигурации (~/.claude/settings.json):

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "APIFREAKS_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

Codex CLI

codex mcp add apifreaks --env APIFREAKS_API_KEY=your_apikey_here --env APIFREAKS_MODULES=ip-intelligence,currency,whois,dns,weather -- npx -y @apifreaks/mcp

Начните новую сессию Codex после добавления сервера.


Claude Desktop

Отредактируйте claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "APIFREAKS_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

Перезапустите Claude Desktop после сохранения.


Cursor

Создайте или отредактируйте .cursor/mcp.json в корне проекта (или ~/.cursor/mcp.json для глобальной настройки):

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "APIFREAKS_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

Или перейдите в Cursor Settings → MCP и добавьте сервер через интерфейс.


Windsurf

Отредактируйте ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "APIFREAKS_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

Cline

Откройте панель MCP Servers в Cline, нажмите Configure, затем Advanced MCP Settings, чтобы открыть cline_mcp_settings.json. Или отредактируйте его напрямую:

  • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

  • Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

  • Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "APIFREAKS_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

Перезапустите Cline после сохранения.


OpenCode

Отредактируйте ~/.config/opencode/config.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "apifreaks": {
      "type": "local",
      "command": ["npx", "-y", "@apifreaks/mcp"],
      "environment": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "APIFREAKS_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

Gemini CLI

Отредактируйте ~/.gemini/settings.json (или .gemini/settings.json в корне проекта для конфигурации уровня проекта):

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "APIFREAKS_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

VS Code (GitHub Copilot / Continue)

Создайте .vscode/mcp.json в вашем рабочем пространстве:

{
  "servers": {
    "apifreaks": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "APIFREAKS_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

Glama

Сервер APIFreaks MCP указан на Glama. Glama предоставляет подключение в один клик и автоматическую настройку для Claude Desktop и других MCP-клиентов, а также регулярные проверки безопасности и оценку качества инструментов.

Нажмите Connect на странице Glama и следуйте подсказкам — он автоматически сгенерирует правильную конфигурацию для вашего клиента.


Доступные инструменты

IP Intelligence (ip-intelligence) — 4 инструмента

Геолокация, ISP, сеть и данные об угрозах для любого IP-адреса.

Инструмент

Описание

ipgeolocation_lookup

Данные геолокации для IP, IPv6-адреса или имени хоста

ipgeolocation_bulk_lookup

Данные геолокации для до 50 000 IP в одном запросе

ip_security_lookup

Оценка угрозы, обнаружение VPN/прокси/Tor/ботов для одного IP

ip_security_bulk_lookup

Анализ угроз для до 50 000 IP в одном запросе


Геокодирование (geocoding) — 2 инструмента

Преобразование адреса ↔ координат.

Инструмент

Описание

geocode_forward

Преобразование адреса или названия места в координаты

geocode_reverse

Преобразование координат в почтовый адрес


WHOIS (whois) — 6 инструментов

Данные о владельцах доменов и IP, включая исторические записи.

Инструмент

Описание

whois_domain_lookup

Живая запись WHOIS для доменного имени

whois_ip_lookup

Данные WHOIS о владельце и сети для IPv4 или IPv6-адреса

whois_asn_lookup

Данные WHOIS для номера автономной системы (ASN)

whois_domain_history

Исторические снимки WHOIS для домена (данные с 1986 года)

whois_reverse_lookup

Поиск записей WHOIS по имени владельца, email, компании или ключевому слову

whois_bulk_domain_lookup

Живые данные WHOIS для до 100 доменов одновременно


DNS (dns) — 4 инструмента

Живые DNS-записи, история и обратные запросы.

Инструмент

Описание

dns_lookup

Реальные DNS-записи для имени хоста — A, AAAA, MX, NS, TXT, CNAME, SOA, SPF

dns_history

Исторические снимки DNS-записей для имени хоста

dns_reverse

Поиск всех имён хостов, указывающих на конкретное значение DNS-записи

dns_bulk_lookup

Реальные DNS-записи для до 100 имён хостов одновременно


Скрапер (scraper) — 2 инструмента

Извлечение HTML или структурированных полей из URL. Сначала статический режим; рендеринг JS только когда странице нужен браузер.

Инструмент

Описание

scraper_scrape

Скрапинг статического HTML (опционально извлечение / отправка формы). Пустые инструкции возвращают полную страницу

scraper_scrape_js

Скрапинг с рендерингом JavaScript, шагами браузера, прокси и опциональным решением CAPTCHA


Проверка email (email-validation) — 2 инструмента

Проверка доставляемости, синтаксиса, домена и необязательное обогащение по IP.

Инструмент

Описание

email_validate

Проверка одного email-адреса

email_bulk_validate

Проверка до 100 email-адресов за один запрос


Проверка телефона (phone-validation) — 2 инструмента

Оператор, тип линии, местоположение и стандартизированные форматы.

Инструмент

Описание

phone_validate

Проверка одного номера телефона

phone_bulk_validate

Проверка до 100 номеров телефонов за один запрос


SSL (ssl) — 2 инструмента

Актуальные данные SSL-сертификатов для любого домена.

Инструмент

Описание

ssl_live_lookup

Получить актуальный SSL-сертификат для домена

ssl_live_chain_lookup

Получить полную цепочку SSL-сертификатов для домена


Домен (domain) — 4 инструмента

Проверка доступности доменов с поддержкой пакетных запросов, подсказками и поиском поддоменов.

Инструмент

Описание

domain_check_availability

Проверка, доступно ли доменное имя для регистрации

domain_check_availability_with_suggestions

Проверка доступности и получение альтернативных вариантов доменов

domain_subdomain_lookup

Постраничный список обнаруженных поддоменов для домена

domain_bulk_check_availability

Проверка доступности до 100 доменов одновременно


Скриншот (screenshot) — 3 инструмента

Создание скриншотов и записей прокрутки любой веб-страницы.

Инструмент

Описание

screenshot_capture

Сделать скриншот веб-страницы и вернуть URL изображения

screenshot_bulk_capture

Сделать скриншоты до 50 веб-страниц за один запрос

screenshot_capture_scrolling

Записать видео прокрутки или анимированный GIF веб-страницы


PDF (pdf) — 20 инструментов

Объединение, разделение, извлечение или удаление страниц, преобразование в изображения, генерация из шаблонов, сжатие, поворот, шифрование/ограничение, дешифрование/снятие ограничений и линеаризация.

Задачи (объединение, разделение, преобразование и т. д.) выполняются асинхронно: они возвращают taskId. Проверяйте ход выполнения с помощью pdf_task_status. Для локальных файлов требуется абсолютный путь (MCP-сервер читает диск). Также можно передать сохранённый file_id. Генерация из шаблонов (pdf_generate, pdf_generate_bulk) выполняется синхронно и возвращает размещённый pdf_url.

Завершённые задачи включают URL для скачивания. Добавьте свой API-ключ как параметр запроса apiKey или заголовок X-apiKey.

Инструмент

Описание

pdf_merge

Объединение PDF-файлов (локальные пути и/или сохранённые ID файлов)

pdf_split

Разделение PDF по диапазонам страниц

pdf_extract_pages

Извлечение страниц в новый PDF или ZIP

pdf_remove_pages

Удаление страниц из PDF

pdf_to_image

Преобразование страниц в PNG, JPG, TIFF, BMP или GIF

pdf_generate

Рендеринг шаблона с JSON и получение размещённого URL PDF

pdf_generate_bulk

Рендеринг одного PDF на каждую строку CSV

pdf_compress

Уменьшение размера PDF-файла

pdf_rotate

Поворот страниц

pdf_encrypt

Защита PDF паролем

pdf_restrict

Ограничение печати, копирования и редактирования

pdf_decrypt

Снятие шифрования

pdf_unrestrict

Снятие ограничений прав доступа

pdf_linearize

Линеаризация для быстрого просмотра в вебе

pdf_task_status

Проверка одной асинхронной задачи (queued / processing / completed / failed)

pdf_file_status

Метаданные сохранённого файла

pdf_files

Список сохранённых PDF-файлов

pdf_file_delete

Удаление сохранённого PDF

pdf_upload

Загрузка локальных PDF-файлов и получение ID файлов

pdf_upload_binary

Загрузка одного большого PDF в виде сырых байтов и получение ID файла


Валюта (currency) — 12 инструментов

Актуальные и исторические курсы обмена для 170+ фиатных валют и 830+ криптовалют.

Инструмент

Описание

currency_latest_rates

Актуальные курсы обмена для всех поддерживаемых валют

currency_historical_rates

Курсы обмена на конкретную прошедшую дату

currency_latest_converter

Конвертация суммы между валютами по актуальным курсам

currency_historical_converter

Конвертация по курсам на конкретную прошедшую дату

currency_time_series

Посуточные курсы обмена за произвольный период

currency_fluctuation

Показатели колебаний курсов и процентное изменение за период

currency_geo_convert

Конвертация в местную валюту страны IP-адреса

currency_supported

Полный список поддерживаемых валют с метаданными

currency_symbols

Соответствие символов валют их названиям

currency_symbol_info

Проверка символа валюты и получение его полного названия

currency_historical_data_limits

Окно доступности исторических данных для каждой валюты

currency_historical_data_limit_info

Окно доступности исторических данных для одного кода валюты


Сырьевые товары (commodity) — 7 инструментов

Цены в реальном времени и исторические цены на сырьевые товары, такие как золото, нефть и сельскохозяйственная продукция.

Инструмент

Описание

commodity_latest_rates

Цены в реальном времени на один или несколько сырьевых товаров

commodity_historical_rates

Исторические цены OHLC на сырьевые товары за конкретную дату

commodity_fluctuation

Показатели колебаний цен за период

commodity_time_series

Ежедневные цены OHLC за период (до 365 дней)

commodity_symbols

Список всех поддерживаемых символов сырьевых товаров с метаданными

commodity_symbol_info

Проверка символа сырьевого товара и получение его полных данных

commodity_quotes

Список всех поддерживаемых валют котировок для цен на сырьевые товары


Финансы (financial) — 9 инструментов

Ставки НДС, проверка номеров НДС, валидация IBAN и поиск по SWIFT/BIC.

Инструмент

Описание

financial_vat_rates_by_country

Ставки НДС для страны, опционально по штатам

financial_vat_rates_bulk

Ставки НДС для до 100 стран/штатов

financial_vat_rates_by_ip

Ставки НДС для страны, определённой по IP-адресу

financial_vat_validate

Проверка номера НДС ЕС (VIES) или Великобритании (HMRC)

financial_iban_validate

Проверка IBAN (формат, контрольная сумма, метаданные банка/SEPA)

financial_swift_lookup

Банковские реквизиты для 8- или 11-значного кода SWIFT/BIC

financial_swift_finder

Детализация: страна → банк → город → коды SWIFT/BIC

financial_supported_countries

Страны (и штаты НДС), поддерживаемые API VAT, IBAN и SWIFT

financial_supported_country_info

Проверка, поддерживается ли одна страна API VAT, IBAN и/или SWIFT


Почтовый индекс (zipcode) — 7 инструментов

Поиск почтовых индексов, поиск по радиусу и расчёт расстояний по всему миру.

Инструмент

Описание

zipcode_lookup

Поиск ZIP-кода или почтового индекса — город, регион, страна, координаты

zipcode_radius_search

Поиск всех ZIP-кодов в заданном радиусе от центральной точки

zipcode_distance

Расчёт расстояния от базовой точки до 100 ZIP-кодов

zipcode_by_city

Получение всех ZIP-кодов/почтовых индексов для города

zipcode_bulk_lookup

Поиск до 100 ZIP-кодов/почтовых индексов за один раз

zipcode_distance_match

Поиск всех пар ZIP-кодов в пределах заданного порога расстояния

zipcode_by_region

Получение всех ZIP-кодов/почтовых индексов для штата, провинции или региона


Погода (weather) — 9 инструментов

Текущие условия, прогнозы, исторические данные, мониторинг окружающей среды и астрономия.

Инструмент

Описание

weather_current

Текущая погода для любого места — температура, влажность, ветер, давление, AQI

weather_forecast

Прогноз до 16 дней вперёд с точностью по дням, часам или минутам

weather_historical

Историческая погода на любую прошедшую дату (данные с 1940 года)

weather_time_series

Историческая погода за произвольный период

weather_air_quality

Индекс качества воздуха в реальном времени или прогноз, а также разбивка по загрязнителям

weather_marine

Морская и океаническая погода, в реальном времени или прогноз до 16 дней

weather_flood_forecast

Прогноз наводнений с данными о расходе реки и процентилях стока

weather_bulk_current

Текущая погода для до 50 мест за один запрос

astronomy_lookup

Восход, закат, фаза Луны, сумерки, золотой час, солнечный полдень, восход Луны и положения Солнца/Луны


География (geography) — 10 инструментов

Страны, города, административные единицы, регионы и изображения флагов.

Инструмент

Описание

geodb_admin_levels

Типы административных уровней для страны

geodb_admin_units

Штаты, провинции и другие административные единицы страны

geodb_admin_unit_details

Подробная информация об одной административной единице

geodb_countries

Список стран с кодами ISO, столицами и регионами

geodb_country_details

Полные метаданные для одной страны по коду alpha-2

geodb_cities

Города страны, опционально отфильтрованные по административной единице

geodb_regions

Список регионов GeoDB (Африка, Америка, Азия, Европа, Океания, Полярный)

geodb_subregions

Список субрегионов, опционально отфильтрованных по региону

geodb_flags_supported

Поддерживаемые идентификаторы флагов стран и организаций

geodb_flag

Получить изображение флага страны или организации


Часовой пояс (timezone) — 2 инструмента

Поиск часовых поясов и конвертация времени с использованием любого идентификатора местоположения.

Инструмент

Описание

timezone_lookup

Информация о часовом поясе для местоположения — принимает IP, город/долготу, IATA, ICAO или UN/LOCODE

timezone_convert

Конвертация даты и времени из одного часового пояса в другой


Пользовательский агент (user-agent) — 2 инструмента

Разбор строк пользовательских агентов для извлечения информации о браузере, устройстве и операционной системе.

Инструмент

Описание

user_agent_parse

Разбор строки пользовательского агента — браузер, устройство, ОС, движок

user_agent_bulk_parse

Разбор до 100 строк пользовательских агентов за один запрос


Поддержка


Лицензия

Этот проект распространяется под лицензией Apache License 2.0. Вы можете свободно использовать, изменять и распространять это программное обеспечение в соответствии с условиями лицензии.


Политика конфиденциальности

Ваши API-запросы обрабатываются компанией APIFreaks в соответствии с их политикой конфиденциальности. Подробную информацию о том, как собираются и обрабатываются данные, см. в разделе apifreaks.com/privacy-policy.

Available Tools

1 tool
list_modulesDiscover APIFreaks modulesA
Read-onlyIdempotent

APIFreaks module catalog (opt-in via ENABLE_MODULES). Call when a needed capability is missing from your tool list, or to check whether APIFreaks covers a topic. Live tools for enabled modules already appear in tools/list; this returns needs_enable[] with paste-ready enable_line values — give the user that ENABLE_MODULES=... line and ask them to restart. Modules: ip-intelligence, geocoding, whois, dns, scraper, email-validation, phone-validation, ssl, domain, screenshot, pdf, currency, commodity, financial, zipcode, weather, geography, timezone, user-agent. ENABLE_MODULES unset — only this tool is registered (example: ENABLE_MODULES=ip-intelligence,whois,dns,domain,weather).

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safe-read profile (readOnly, idempotent, openWorld, non-destructive). The description goes well beyond them by disclosing the opt-in gating model, the fact that only this tool registers when ENABLE_MODULES is unset, the shape of the returned payload, and the required restart to activate modules.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose and trigger conditions are front-loaded, and the operator instructions come before the long module enumeration. The 19-module list is dense but serves a real discovery purpose, so it earns its space, though it slightly lengthens the definition.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description carries the full burden and does so: it explains the return value, the enablement workflow, and the restart requirement. An agent has everything needed to call it and act on its output.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool takes zero parameters, so the 4 baseline applies. The description compensates usefully by explaining the returned payload (needs_enable[], paste-ready enable_line), which is the only 'input-like' detail an agent needs to act on the result.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific resource ('APIFreaks module catalog') and states exactly what the tool returns (needs_enable[] with enable_line values) and under what opt-in condition it exists. An agent can distinguish this discovery tool from the live module tools without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives explicit triggers ('Call when a needed capability is missing from your tool list, or to check whether APIFreaks covers a topic'), clarifies that enabled tools already appear in tools/list, and prescribes the follow-up action (hand the user the ENABLE_MODULES line and ask for a restart). Nothing is left to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 60 tool updatesv2.0.0
    • Removedastronomy_lookup
    • Removedcommodity_fluctuation
    • Removedcommodity_historical_rates
    • Removedcommodity_latest_rates
    • Removedcommodity_quotes
    • Removedcommodity_symbol_info
    • Removedcommodity_symbols
    • Removedcommodity_time_series
    • Removedcurrency_fluctuation
    • Removedcurrency_geo_convert
    • Removedcurrency_historical_converter
    • Removedcurrency_historical_rates
    • Removedcurrency_latest_converter
    • Removedcurrency_latest_rates
    • Removedcurrency_supported
    • Removedcurrency_symbol_info
    • Removedcurrency_symbols
    • Removedcurrency_time_series
    • Removeddns_bulk_lookup
    • Removeddns_history
    • Removeddns_lookup
    • Removeddns_reverse
    • Removeddomain_bulk_check_availability
    • Removeddomain_check_availability
    • Removeddomain_check_availability_with_suggestions
    • Removedip_security_bulk_lookup
    • Removedip_security_lookup
    • Removedipgeolocation_bulk_lookup
    • Removedipgeolocation_lookup
    • Addedlist_modules
    • Removedscreenshot_bulk_capture
    • Removedscreenshot_capture
    • Removedscreenshot_capture_scrolling
    • Removedssl_live_chain_lookup
    • Removedssl_live_lookup
    • Removedtimezone_convert
    • Removedtimezone_lookup
    • Removeduser_agent_bulk_parse
    • Removeduser_agent_parse
    • Removedweather_air_quality
    • Removedweather_bulk_current
    • Removedweather_current
    • Removedweather_flood_forecast
    • Removedweather_forecast
    • Removedweather_historical
    • Removedweather_marine
    • Removedweather_time_series
    • Removedwhois_asn_lookup
    • Removedwhois_bulk_domain_lookup
    • Removedwhois_domain_history
    • Removedwhois_domain_lookup
    • Removedwhois_ip_lookup
    • Removedwhois_reverse_lookup
    • Removedzipcode_bulk_lookup
    • Removedzipcode_by_city
    • Removedzipcode_by_region
    • Removedzipcode_distance
    • Removedzipcode_distance_match
    • Removedzipcode_lookup
    • Removedzipcode_radius_search
  2. 4 tool updatesv1.1.2
    • Addedip_security_bulk_lookup
    • Addedip_security_lookup
    • Changedipgeolocation_bulk_lookup2 fields changed
      • changedInput schema / properties / include / description
        Previous value: -"Additional data modules to include. Available: security, hostname, liveHostname, hostnameFallbackLive, user_agent, abuse, dma_code, time_zone, geo_accuracy."New value: +"Additional data modules to include. Available: security, hostname, liveHostname, hostnameFallbackLive, user_agent, abuse, dma_code, geo_accuracy. Use '*' to include all modules. Note: 'security' and 'abuse' fields cost extra credits."
      • changedInput schema / properties / include / items / enum
        Previous value: -[
        -  "security",
        -  "hostname",
        -  "liveHostname",
        -  "hostnameFallbackLive",
        -  "user_agent",
        -  "abuse",
        -  "dma_code",
        -  "time_zone",
        -  "geo_accuracy"
        -]New value: +[
        +  "security",
        +  "hostname",
        +  "liveHostname",
        +  "hostnameFallbackLive",
        +  "user_agent",
        +  "abuse",
        +  "dma_code",
        +  "geo_accuracy",
        +  "*"
        +]
    • Changedipgeolocation_lookup2 fields changed
      • changedInput schema / properties / include / description
        Previous value: -"Additional data modules to include. Available: security, hostname, liveHostname, hostnameFallbackLive, user_agent, abuse, dma_code, time_zone, geo_accuracy."New value: +"Additional data modules to include. Available: security, hostname, liveHostname, hostnameFallbackLive, user_agent, abuse, dma_code, geo_accuracy. Use '*' to include all modules. Note: 'security' and 'abuse' fields cost extra credits."
      • changedInput schema / properties / include / items / enum
        Previous value: -[
        -  "security",
        -  "hostname",
        -  "liveHostname",
        -  "hostnameFallbackLive",
        -  "user_agent",
        -  "abuse",
        -  "dma_code",
        -  "time_zone",
        -  "geo_accuracy"
        -]New value: +[
        +  "security",
        +  "hostname",
        +  "liveHostname",
        +  "hostnameFallbackLive",
        +  "user_agent",
        +  "abuse",
        +  "dma_code",
        +  "geo_accuracy",
        +  "*"
        +]
  3. 57 tool updatesv1.0.0
    • First observedastronomy_lookup
    • First observedcommodity_fluctuation
    • First observedcommodity_historical_rates
    • First observedcommodity_latest_rates
    • First observedcommodity_quotes
    • First observedcommodity_symbol_info
    • First observedcommodity_symbols
    • First observedcommodity_time_series
    • First observedcurrency_fluctuation
    • First observedcurrency_geo_convert
    • First observedcurrency_historical_converter
    • First observedcurrency_historical_rates
    • First observedcurrency_latest_converter
    • First observedcurrency_latest_rates
    • First observedcurrency_supported
    • First observedcurrency_symbol_info
    • First observedcurrency_symbols
    • First observedcurrency_time_series
    • First observeddns_bulk_lookup
    • First observeddns_history
    • First observeddns_lookup
    • First observeddns_reverse
    • First observeddomain_bulk_check_availability
    • First observeddomain_check_availability
    • First observeddomain_check_availability_with_suggestions
    • First observedipgeolocation_bulk_lookup
    • First observedipgeolocation_lookup
    • First observedscreenshot_bulk_capture
    • First observedscreenshot_capture
    • First observedscreenshot_capture_scrolling
    • First observedssl_live_chain_lookup
    • First observedssl_live_lookup
    • First observedtimezone_convert
    • First observedtimezone_lookup
    • First observeduser_agent_bulk_parse
    • First observeduser_agent_parse
    • First observedweather_air_quality
    • First observedweather_bulk_current
    • First observedweather_current
    • First observedweather_flood_forecast
    • First observedweather_forecast
    • First observedweather_historical
    • First observedweather_marine
    • First observedweather_time_series
    • First observedwhois_asn_lookup
    • First observedwhois_bulk_domain_lookup
    • First observedwhois_domain_history
    • First observedwhois_domain_lookup
    • First observedwhois_ip_lookup
    • First observedwhois_reverse_lookup
    • First observedzipcode_bulk_lookup
    • First observedzipcode_by_city
    • First observedzipcode_by_region
    • First observedzipcode_distance
    • First observedzipcode_distance_match
    • First observedzipcode_lookup
    • First observedzipcode_radius_search

TDQS

A4.5/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no risk of confusion or misselection between tools. The tool's purpose (listing available APIFreaks modules) is clearly distinct.

Naming Consistency5/5

The single tool name list_modules follows a clear verb_noun snake_case convention. Consistency is trivially perfect for a one-tool server.

Tool Count3/5

One tool is borderline thin for a server intended to expose many APIFreaks capabilities. The discovery gate design is reasonable, but the default surface feels under-scoped.

Completeness2/5

The default surface only lists modules and provides enable instructions, with no actual API operations available until restart. This is a significant gap for agents expecting to use APIFreaks services immediately.

Maintenance

ActivityActive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to access real-time and historical weather data through multiple weather APIs including OpenMeteo, Tomorrow.io, and OpenWeatherMap. Provides comprehensive meteorological information including current conditions, forecasts, historical data, and weather alerts.
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to fetch real-time weather data, forecasts up to 10 days, and compare weather conditions between cities using WeatherAPI.com with support for both Celsius and Fahrenheit units.
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides real-time weather data and forecasts for locations worldwide using the OpenWeatherMap API. It enables AI assistants to retrieve current conditions, temperature, and forecasts through a simple tool-based interface.
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides live weather data (current conditions, forecasts) and city geocoding through Open-Meteo API, enabling AI assistants to answer weather queries without an API key.
    MIT