APIFreaks 公式の Model Context Protocol (MCP) サーバーです。Claude、Cursor、Windsurf、その他の MCP 互換クライアントに追加すると、AI は天気、ドメイン、IP、DNS レコード、SSL 証明書、通貨レート、商品価格、スクリーンショット、PDF、Webスクレイピング、VAT/IBAN/SWIFT、メール・電話番号の検証、ジオコーディングなどを即座に参照できます。
接続しで、どんなことを質問できるの？
🌦 | 「東京の7日間の天気予報はどうですか？傘は持っていくべきですか？」 |
🔒 | 「stripe.com の SSL 証明書を確認してください。有効ですか？期限はいつ切れますか？」 |
🌍 | 「openai.com は誰が登録していて、いつ登録されましたか？最近組 WHOIS レコードは変更されましたか？」 |
💱 | 「2500 USD を今日のライブレートで EUR、GBP、JPY に換算してください。」 |
📈 | 「これら 20 件のドメイン名が登録可能かどうか確認してください。」 |
📡 | 「github.com の DNS レコードはどうなっていますか？ MX と TXT レコードを完全に表示してください。」 |
Related MCP server: Weather MCP Server
変数 | 必須 | 説明 |
| 必須 | あなたの APIFreaks API キー — apifreaks.com で取得 |
| 必須 | 公開するモジュールのカンマ区切りリスト。未設定または空の場合、 |
このサーバーは多くの API をカバーしています。それらすべてを tools/list で公開するとクライアントのコンテキストウィンドウを占有してしまうため、実際に必要なモジュールのみを手動で選択します。
MCP クライアントの設定で APIFREAKS_MODULES を設定してください。設定したモジュールだけが登録されるため、tools/list はそのサブセットのみ返します。この変数がない、または空の場合、API ではなく listのみが表示されます。それを呼び出して各モジュールとその中のツールを確認し、APIFREAKS_MODULES=... を含む完全な行（新しい名前だけでなく、必要なすべてのモジュール）を貼り付けて再起動してください。
APIFREAKS_MODULES=ip-intelligence,currency,whois,dns,weatherハイフンとアンダースコアは同じように扱われます（user-agent と user_agent のどちらでも機能します）。不明な名前は無視され、stderr にログされます。
モジュール | ツール |
| IP 位置情報と脅威インテリジェンス（単一 + 一括） |
| フォワードおよびリバースオジオコーディング |
| ドメイン、IP、ASN、履歴、リバース、一括 |
| ライブ検索、履歴、リバース、一括 |
| 静的 HTML スクレイピングと JS レンダリングスクレイピング |
| 単一およびバルクのメールアドレス検証 |
| 電話番号の単一・一括検証 |
| ライブ証明書と完全なチェーン |
| 可用性チェック、提案、一括、サブドDomain 検索 |
| キャプチャ, スクリーンショット、スクロールキャプチャ、一括 |
| 結合、分割、圧縮、保護、変換、生成 |
| ライブ/過去レート、変換、時系列、記号、制限 |
| ライブ/過去の価格、変動、時系列、銘柄 |
| VAT 税率、VAT 番号、IBAN、SWIFT/BIC |
| 検索、半径、距離、市区 / 地域 |
| 現在、予報、過去、大気質、海象、洪水、天文 |
| 行政区域、国、都市、地域、国旗 |
| 検索と変換 |
| 単一・バルクのユーザーエージ１の解析 |
apifreaks.com にサインインするか、無料アカウントを作成します。API キーはダッシュボードの API Keys にあります。
完全な API ドキュメ・サイト：apifreaks.com/docs
最速の接続方法 — Claude Code CLI 経由：
claude mcp add apifreaks -e APIFREAKS_API_KEY=your_apikey_here -e APIFREAKS_MODULES=ip-intelligence,currency,whois,dns,weather -- npx -y @apifreaks/mcpip-intelligence,currency,whois,dns,weather を、必要なモジュールに置き換えてください。Cursor、Windsurf、Cline、その他についてはを 統合ガイド を参照してください。
ターミナルから（推奨）：
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 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_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/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 に移動し、UI からサーバーを追加します。
~/.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 サーバー panel を開き、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 を再起動してください。
~/.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/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"
}
}
}
}ワークスペースに .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"
}
}
}
}APIFreaks MCP サーバーは Glama に登録されています。Glama は、Claude Desktop やその他の MCP クライアントへのワンクリック接続と自動設定を提供し、通常のセキュリティスキャンとツール品質スコアも行います。
Glama の接続ボタンをクリックし、指示に従ってください。クライアントに適した設定が自動的に生成されます。
ip-intelligence) — 4 ツール任意の IP の位置情報、ISP、ネットワーク、脅威データ。
ツール | 説明 |
| IP アドレス、IPv6 アドレス、またはホスト名の位置情報データ |
| 1 リクエストで最大 50,000 個の IP の位置情報データ |
| 単一 IP の脅威スcore、VPN / プロキシー / Tor / bot 検出 |
| 一括ウの脅威インテリジェンス（最大 50,000 件） |
geocoding) — 2 ツール住所 ↔ 座標の変換。
ツール | 説明 |
| 住所または地名を座標に変換する |
| 座標を住所に変換する |
whois) — 6 ツール履歴も含むドメインおよびIPの所有情報。
ツール | 説明 |
| ドメイン名のリアルタイム WHOIS 情報 |
| IPv4 または IPv6 アドレスの WHOIS 所有情報とネットワークデータ |
| ASN（Autonomous System Number）の WHOIS 情報 |
| ドメインの過去の WHOIS スナップショット（データは1999年までさかのぼる） |
| 所有者名、メール、会社名、キーワードで WHOIS を検索 |
| 一度に最大 100 ドメインのリアルタイム WHOIS 情報 |
dns) — 4 ツールリアルタイムの DNS レコード、履歴、逆引き を検索。
ツール | 説明 |
| ホスト名のリアルタイム DNS レコード — A, AAAA, MX, NS, TXT, CNAME, SOA, SPF |
| ホスト名の過去の DNS レコードスナップショット |
| 特定の DNS レコード値に向かうすべてのホスト名を検索 |
| 一度に最大 100 ホスト名のリアルタイム DNS レコード |
scraper) — 2 ツールURL から HTML を構造化フィールドとして抽出します。静的モード優先で、JS レンダリングはページがブラウザを必要とする場合のみ使用します。
ツール | 説明 |
| 静的 HTML をスクレイピング（オプション: 抽出 / 特定）。空の指示はページ全体を表示します |
| JavaScript レンダリング、ブラウザステップ、プロキシ、オプションの CAPTCHA 解決によるスクレイピング |
### メール検証（`email-validation`）— 2ツール
配信可能性、構文、ドメイン、およびオプションのIPエンリッチメント。
| ツール | 説明 |
| --------------------- | ------------------------------------------------- |
| `email_validate` | 単一のメールアドレスを検証する |
| `email_bulk_validate` | 1回のリクエストで最大100件のメールアドレスを検証する |
***
### 電話番号検証（`phone-validation`）— 2ツール
キャリア、回線種別、所在地、および標準化された形式。
| ツール | 説明 |
| --------------------- | ----------------------------------------------- |
| `phone_validate` | 単一の電話番号を検証する |
| `phone_bulk_validate` | 1回のリクエストで最大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ツール
任意のWebページのスクリーンショットとスクロール録画をキャプチャします。
| ツール | 説明 |
| ------------------------------ | ---------------------------------------------------------- |
| `screenshot_capture` | Webページのスクリーンショットをキャプチャし、画像URLを返す |
| `screenshot_bulk_capture` | 1回のリクエストで最大50件のWebページのスクリーンショットをキャプチャする |
| `screenshot_capture_scrolling` | Webページのスクロール動画またはアニメーション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でテンプレートをレンダリングし、ホストされたPDF URLを取得する |
| `pdf_generate_bulk` | CSVの行ごとに1つのPDFをレンダリングする |
| `pdf_compress` | PDFファイルサイズを削減する |
| `pdf_rotate` | ページを回転する |
| `pdf_encrypt` | PDFをパスワードで保護する |
| `pdf_restrict` | 印刷、コピー、編集を制限する |
| `pdf_decrypt` | 暗号化を解除する |
| `pdf_unrestrict` | 権限制限を解除する |
| `pdf_linearize` | Fast Web View用にリニアライズする |
| `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を1つ生のバイトとしてアップロードしてファイル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` | 1つの通貨コードの履歴データ利用可能ウィンドウ |
***
### 商品（`commodity`）— 7ツール
金、石油、農産物などの商品のリアルタイムおよび履歴価格。
| ツール | 説明 |
| ---------------------------- | --------------------------------------------------------- |
| `commodity_latest_rates` | 1つ以上の商品のリアルタイム価格 |
| `commodity_historical_rates` | 特定の日付の商品の履歴OHLC価格 |
| `commodity_fluctuation` | 日付範囲にわたる価格変動指標 |
| `commodity_time_series` | 日付範囲（最大365日）にわたる日次OHLC価格 |
| `commodity_symbols` | メタデータ付きのサポートされているすべての商品記号を一覧する |
| `commodity_symbol_info` | 商品記号を検証し、その完全な詳細を取得する |
| `commodity_quotes` | 商品価格設定でサポートされているすべてのクォート通貨を一覧する |
***
### 金融（`financial`）— 9ツール
VAT税率、VAT番号チェック、IBAN検証、およびSWIFT/BICルックアップ。
| ツール | 説明 |
| ---------------------------------- | ----------------------------------------------------------------- |
| `financial_vat_rates_by_country` | 国のVAT税率（オプションで州別） |
| `financial_vat_rates_bulk` | 最大100の国/州のVAT税率 |
| `financial_vat_rates_by_ip` | IPアドレスから解決された国のVAT税率 |
| `financial_vat_validate` | EU（VIES）または英国（HMRC）のVAT番号を検証する |
| `financial_iban_validate` | IBANを検証する（形式、チェックサム、銀行/SEPAメタデータ） |
| `financial_swift_lookup` | 8桁または11桁のSWIFT/BICコードの銀行詳細 |
| `financial_swift_finder` | 国 → 銀行 → 都市 → SWIFT/BICコードへドリルダウン |
| `financial_supported_countries` | VAT、IBAN、およびSWIFT APIでサポートされている国（およびVAT州） |
| `financial_supported_country_info` | 1つの国がVAT、IBAN、および/またはSWIFTでサポートされているか確認する |
***
### 郵便番号（`zipcode`）— 7ツール
世界中の郵便番号ルックアップ、半径検索、および距離計算。
| ツール | 説明 |
| ------------------------ | ----------------------------------------------------------------- |
| `zipcode_lookup` | 郵便番号を検索する — 都市、地域、国、座標 |
| `zipcode_radius_search` | 中心点から指定半径内のすべての郵便番号を検索する |
| `zipcode_distance` | 基準点から最大100件の郵便番号までの距離を計算する |
| `zipcode_by_city` | 都市のすべての郵便番号を取得する |
| `zipcode_bulk_lookup` | 一度に最大100件の郵便番号を検索する |
| `zipcode_distance_match` | 指定された距離しきい値内のすべての郵便番号ペアを検索する |
| `zipcode_by_region` | 州、県、または地域のすべての郵便番号を取得する |
***
### 天気（`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` | 1回のリクエストで最大50の場所の現在の天気 |
| `astronomy_lookup` | 日の出、日の入り、月相、薄明、ゴールデンアワー、太陽南中、月の出、および太陽/月の位置 |
***
### 地理（`geography`）— 10ツール
国、都市、行政単位、地域、および国旗画像。
| ツール | 説明 |
| -------------------------- | ---------------------------------------------------------------- |
| `geodb_admin_levels` | 国の行政レベル種別 |
| `geodb_admin_units` | 国の州、省、その他の行政単位 |
| `geodb_admin_unit_details` | 1つの行政単位の詳細 |
| `geodb_countries` | ISOコード、首都、地域を含む国の一覧 |
| `geodb_country_details` | alpha-2コードによる1か国の完全なメタデータ |
| `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ツール
ユーザーエージェント文字列を解析して、ブラウザ、OS、デバイス情報を抽出します。
| ツール | 説明 |
| ----------------------- | ------------------------------------------------- |
| `user_agent_parse` | ユーザーエージェント文字列を解析 — ブラウザ、デバイス、OS、エンジン |
| `user_agent_bulk_parse` | 1回のリクエストで最大100件のユーザーエージェント文字列を解析 |
***
## サポート
* **メール:** <support@apifreaks.com>
* **ステータス:** [status.apifreaks.com](https://status.apifreaks.com)
* **問題報告:** [github.com/api-freaks/apifreaks-mcp/issues](https://github.com/api-freaks/apifreaks-mcp/issues)
***
## ライセンス
このプロジェクトは[Apache License 2.0](./LICENSE)の下でライセンスされています。ライセンスの条件に従って、このソフトウェアを自由に使用、変更、配布することができます。
***
## プライバシーポリシー
お客様のAPIリクエストは、APIFreaksのプライバシーポリシーに従って処理されます。データの収集と取り扱いの詳細については、[apifreaks.com/privacy-policy](https://apifreaks.com/privacy-policy)をご覧ください。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).
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
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.
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.
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.
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.
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.
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.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
v2.0.0astronomy_lookupcommodity_fluctuationcommodity_historical_ratescommodity_latest_ratescommodity_quotescommodity_symbol_infocommodity_symbolscommodity_time_seriescurrency_fluctuationcurrency_geo_convertcurrency_historical_convertercurrency_historical_ratescurrency_latest_convertercurrency_latest_ratescurrency_supportedcurrency_symbol_infocurrency_symbolscurrency_time_seriesdns_bulk_lookupdns_historydns_lookupdns_reversedomain_bulk_check_availabilitydomain_check_availabilitydomain_check_availability_with_suggestionsip_security_bulk_lookupip_security_lookupipgeolocation_bulk_lookupipgeolocation_lookuplist_modulesscreenshot_bulk_capturescreenshot_capturescreenshot_capture_scrollingssl_live_chain_lookupssl_live_lookuptimezone_converttimezone_lookupuser_agent_bulk_parseuser_agent_parseweather_air_qualityweather_bulk_currentweather_currentweather_flood_forecastweather_forecastweather_historicalweather_marineweather_time_serieswhois_asn_lookupwhois_bulk_domain_lookupwhois_domain_historywhois_domain_lookupwhois_ip_lookupwhois_reverse_lookupzipcode_bulk_lookupzipcode_by_cityzipcode_by_regionzipcode_distancezipcode_distance_matchzipcode_lookupzipcode_radius_searchv1.1.2ip_security_bulk_lookupip_security_lookupipgeolocation_bulk_lookup2 fields changedInput schema / properties / include / descriptionPrevious 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."Input schema / properties / include / items / enumPrevious 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",
+ "*"
+]ipgeolocation_lookup2 fields changedInput schema / properties / include / descriptionPrevious 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."Input schema / properties / include / items / enumPrevious 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",
+ "*"
+]v1.0.0astronomy_lookupcommodity_fluctuationcommodity_historical_ratescommodity_latest_ratescommodity_quotescommodity_symbol_infocommodity_symbolscommodity_time_seriescurrency_fluctuationcurrency_geo_convertcurrency_historical_convertercurrency_historical_ratescurrency_latest_convertercurrency_latest_ratescurrency_supportedcurrency_symbol_infocurrency_symbolscurrency_time_seriesdns_bulk_lookupdns_historydns_lookupdns_reversedomain_bulk_check_availabilitydomain_check_availabilitydomain_check_availability_with_suggestionsipgeolocation_bulk_lookupipgeolocation_lookupscreenshot_bulk_capturescreenshot_capturescreenshot_capture_scrollingssl_live_chain_lookupssl_live_lookuptimezone_converttimezone_lookupuser_agent_bulk_parseuser_agent_parseweather_air_qualityweather_bulk_currentweather_currentweather_flood_forecastweather_forecastweather_historicalweather_marineweather_time_serieswhois_asn_lookupwhois_bulk_domain_lookupwhois_domain_historywhois_domain_lookupwhois_ip_lookupwhois_reverse_lookupzipcode_bulk_lookupzipcode_by_cityzipcode_by_regionzipcode_distancezipcode_distance_matchzipcode_lookupzipcode_radius_searchScored across 1 tool
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.
The single tool name list_modules follows a clear verb_noun snake_case convention. Consistency is trivially perfect for a one-tool server.
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.
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.
Real-time data API for AI Agents: stocks, weather, forex, logistics, search, scrape, news, IP.
Free web search, 130M+ business records, local search, weather and travel data for AI agents.
Live & historical FX rates and currency conversion for AI agents. No API keys.
Live & historical FX rates and currency conversion for AI agents. No API keys.