Apifreaks Mcp Server

by api-freaks

392 downloads

Not rated

GitHub

Other
AI

About

Official MCP server for APIFreaks. Real-time weather, IP, WHOIS, DNS, SSL, currency, screenshots, and more for any AI agent.

Details

Author: api-freaks
Downloads: 392
Categories: Other, AI

- 8 weather tools (current, forecast, historical, air quality, marine, flood)
- 10 currency tools (live/historical rates, converter, time series)
- 2 IP intelligence tools (geolocation, bulk lookup up to 50,000 IPs)
- 6 WHOIS tools (domain, IP, ASN, history, reverse, bulk)
- 4 DNS tools (live records, history, reverse, bulk)
- 3 domain tools (availability check, suggestions, bulk)
- 2 SSL tools (live certificate and chain lookup)
- 7 commodity tools (symbols, rates, historical, fluctuation)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Apifreaks Mcp Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "apifreaks mcp server": {
            "apifreaks": {
                "command": "npx",
                "args": [
                    "-y",
                    "@apifreaks/mcp"
                ],
                "env": {
                    "APIFREAKS_API_KEY": "<YOUR_APIFREAKS_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "apifreaks mcp server": {
            "apifreaks": {
                "command": "npx",
                "args": [
                    "-y",
                    "@apifreaks/mcp"
                ],
                "env": {
                    "APIFREAKS_API_KEY": "<YOUR_APIFREAKS_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "apifreaks mcp server": {
            "apifreaks": {
                "command": "npx",
                "args": [
                    "-y",
                    "@apifreaks/mcp"
                ],
                "env": {
                    "APIFREAKS_API_KEY": "<YOUR_APIFREAKS_API_KEY>"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "apifreaks mcp server": {
            "apifreaks": {
                "command": "npx",
                "args": [
                    "-y",
                    "@apifreaks/mcp"
                ],
                "env": {
                    "APIFREAKS_API_KEY": "<YOUR_APIFREAKS_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "apifreaks mcp server": {
            "apifreaks": {
                "command": "npx",
                "args": [
                    "-y",
                    "@apifreaks/mcp"
                ],
                "env": {
                    "APIFREAKS_API_KEY": "<YOUR_APIFREAKS_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "apifreaks mcp server": {
            "apifreaks": {
                "command": "npx",
                "args": [
                    "-y",
                    "@apifreaks/mcp"
                ],
                "env": {
                    "APIFREAKS_API_KEY": "<YOUR_APIFREAKS_API_KEY>"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "apifreaks mcp server": {
            "apifreaks": {
                "command": "npx",
                "args": [
                    "-y",
                    "@apifreaks/mcp"
                ],
                "env": {
                    "APIFREAKS_API_KEY": "<YOUR_APIFREAKS_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "apifreaks mcp server": {
            "apifreaks": {
                "command": "npx",
                "args": [
                    "-y",
                    "@apifreaks/mcp"
                ],
                "env": {
                    "APIFREAKS_API_KEY": "<YOUR_APIFREAKS_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "apifreaks mcp server": {
            "apifreaks": {
                "command": "npx",
                "args": [
                    "-y",
                    "@apifreaks/mcp"
                ],
                "env": {
                    "APIFREAKS_API_KEY": "<YOUR_APIFREAKS_API_KEY>"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "apifreaks mcp server": {
            "apifreaks": {
                "command": "npx",
                "args": [
                    "-y",
                    "@apifreaks/mcp"
                ],
                "env": {
                    "APIFREAKS_API_KEY": "<YOUR_APIFREAKS_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "apifreaks mcp server": {
            "apifreaks": {
                "command": "npx",
                "args": [
                    "-y",
                    "@apifreaks/mcp"
                ],
                "env": {
                    "APIFREAKS_API_KEY": "<YOUR_APIFREAKS_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "apifreaks mcp server": {
            "apifreaks": {
                "command": "npx",
                "args": [
                    "-y",
                    "@apifreaks/mcp"
                ],
                "env": {
                    "APIFREAKS_API_KEY": "<YOUR_APIFREAKS_API_KEY>"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "apifreaks mcp server": {
            "apifreaks": {
                "command": "npx",
                "args": [
                    "-y",
                    "@apifreaks/mcp"
                ],
                "env": {
                    "APIFREAKS_API_KEY": "<YOUR_APIFREAKS_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "apifreaks mcp server": {
            "apifreaks": {
                "command": "npx",
                "args": [
                    "-y",
                    "@apifreaks/mcp"
                ],
                "env": {
                    "APIFREAKS_API_KEY": "<YOUR_APIFREAKS_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "apifreaks mcp server": {
            "apifreaks": {
                "command": "npx",
                "args": [
                    "-y",
                    "@apifreaks/mcp"
                ],
                "env": {
                    "APIFREAKS_API_KEY": "<YOUR_APIFREAKS_API_KEY>"
                }
            }
        }
    }
}

From the repository

Install via npx and set the required APIFREAKS_API_KEY environment variable. Quick start: claude mcp add apifreaks -e APIFREAKS_API_KEY=your_apikey_here -- npx -y @apifreaks/mcp or add the server configuration to your client's MCP settings file.

`zipcode_lookup`

Look up a single ZIP or postal code to retrieve its city, region, country, their codes and geographic coordinates. Optionally filter by country using an ISO 3166-1 alpha-2 code.

`zipcode_bulk_lookup`

Look up details for up to 100 ZIP/postal codes at once. Returns an array of results including city, region, country, their codes, and geographic coordinates for each ZIP code. Optionally filter all codes to a single country.

`zipcode_radius_search`

Find all ZIP/postal codes within a given radius of a center point. Specify the center as EITHER a ZIP code + country OR lat/long coordinates. Returns paginated results (up to 500 per page) with each code's distance from center. Max radius per unit: km=100, mi=100, yd=109361, m=100000, ft=328084, in=3937008.

`zipcode_distance`

Calculate the straight-line distance from a base point to each of up to 100 ZIP codes. Specify the base point as EITHER a ZIP code + country OR lat/long coordinates. Returns a distance value for each comparison code.

`zipcode_distance_match`

Find all pairs of ZIP codes within a given distance threshold. All codes must be in the same country. Returns every pair (code_1, code_2) whose distance is ≤ the threshold.

`zipcode_by_city`

Get all ZIP/postal codes for a city. Providing 'state_name' is recommended to disambiguate cities with the same name. Returns paginated results (up to 500 per page).

`zipcode_by_region`

Get all ZIP/postal codes for a state, province, or region. Returns paginated results (up to 500 per page).

`commodity_symbols`

List all supported commodity symbols with full metadata (name, unit, quote currency, exchange, status).

`commodity_symbol_info`

Validate a commodity symbol and return its full metadata (name, unit, quote currency, exchange, status). Use this instead of 'commodity_symbols' when you already have a symbol and just need to confirm it's valid or get its details.

`commodity_quotes`

List all supported commodity quote currencies with symbol and currency name.

`commodity_latest_rates`

Get real-time prices for one or more commodities. Supports custom quote currencies.

`commodity_historical_rates`

Get historical open, high, low, close (OHLC) prices for specific commodities on a specific date. NOTE: If data is unavailable for the exact requested date (e.g. weekends/holidays), this tool will automatically return the rates for the nearest previous available date.

`commodity_fluctuation`

Get price fluctuation for commodity symbols over a date range. If symbols are missing from results or a 404 is returned, use 'commodity_historical_rates' to find valid trading dates and retry.

`commodity_time_series`

Get daily OHLC (Open, High, Low, and Close) prices for commodities over a date range (max 365 days). If symbols are missing from results or a 404 is returned, use 'commodity_historical_rates' to find valid trading dates and retry.

`currency_latest_rates`

Retrieve the latest exchange rates for 170+ fiat currencies and 830+ cryptocurrencies. Returns a 'rates' dictionary mapping currency codes to their rate relative to the base. Filter to specific symbols to reduce response size.

`currency_historical_rates`

Retrieve historical exchange rates for a specific past date. Supports 170+ fiat currencies and 830+ cryptocurrencies with data going back 40+ years.

`currency_latest_converter`

Convert an amount from one currency to another using the latest exchange rates. Supports 170+ fiat currencies and 800+ cryptocurrencies. Returns the exchange rate used, the given amount, and the converted amount.

`currency_historical_converter`

Convert an amount from one currency to another using exchange rates from a specific past date. Useful for financial auditing, tax reporting, and invoice reconciliation. Returns the exchange rate on that date, the given amount, and the converted amount.

`currency_time_series`

Retrieve historical exchange rates day-by-day across a custom date range. Returns a 'historicalRatesList' array where each entry has a date and a 'rates' dictionary. Useful for charting currency trends and analyzing multi-day rate movements. startDate is required; endDate defaults to yesterday if omitted. Max interval supported is 1 year.

`currency_fluctuation`

Retrieve exchange rate fluctuation metrics for currencies over a date range. For each requested currency returns: startRate, endRate, absolute change, and percent change. Useful for volatility analysis and comparing currency movements. startDate is required; endDate defaults to yesterday if omitted.

`currency_geo_convert`

Convert an amount from a given currency to the local currency of an IP address's location. Returns the detected target currency, exchange rate, and converted amount. Useful for e-commerce checkout localization. Supports IPv4 and IPv6.

`currency_supported`

Get the supported currencies map. Each entry includes code, name, country data, status, availability dates, and icon. Covers 170+ fiat currencies and 830+ cryptocurrencies.

`currency_symbols`

Get a map of supported currency symbols to currency names.

`currency_symbol_info`

Validate a currency symbol and return its full name. Use this instead of 'currency_symbols' when you already have a symbol and just need to confirm it's valid or get its display name.

`weather_current`

Get real-time weather for a location, including temperature, humidity, wind, pressure, air quality (AQI), and astronomy (sunrise/sunset/moon phase). Provide at least one of: 'location', lat+long, or 'ip'.

`weather_bulk_current`

Get real-time weather for up to 50 locations at once. Each location in the array can be a city name, lat/long pair, or IP address. Returns weather + astronomy data for each location wrapped in a 'bulk' array.

`weather_forecast`

Get weather forecast for up to 16 days with daily, hourly, or minutely precision. Use EITHER 'forecast_days' OR 'start_date'+'end_date' to define the range, not both. Only current or future dates are allowed. Provide at least one of: 'location', lat+long, or 'ip'.

`weather_historical`

Get historical weather data for a specific past date (back to 1940). Returns daily or hourly weather + astronomy for the given date. Only past dates are allowed — current or future dates are rejected. Provide at least one of: 'location', lat+long, or 'ip'.

`weather_time_series`

Get historical weather data over a date range (time series). Max range: 90 days for daily precision, 7 days for hourly. Only past dates are allowed — current or future dates are rejected. Data available back to 1940. Provide at least one of: 'location', lat+long, or 'ip'.

`weather_air_quality`

Get air quality data either real-time or forecast. Returns PM2.5, PM10, CO, NO₂, SO₂, ozone, dust, and UV index. Real-time mode also includes AQI summary indices (US & EU); forecast mode returns raw pollutant values only. Omit dates for real-time AQI. Provide 'start_date' and 'end_date' for hourly AQI forecast (max 6 days, current/future dates only). NOTE: Use this tool over 'weather_current' when you need standalone or forecast air quality data. Provide at least one of: 'location', lat+long, or 'ip'.

`weather_marine`

Get marine/ocean weather, real-time or forecast, up to 16 days. Returns wave height, swell, wind speed/direction, and sea-surface data. Omit dates for real-time conditions. Provide 'start_date' and 'end_date' for forecast mode (max 16 days, current/future dates only). Coordinates (lat/long) are recommended for offshore/ocean queries since city names resolve to land. Provide at least one of: 'location', lat+long, or 'ip'.

`weather_flood_forecast`

Get flood forecast data — river discharge and flow percentiles (mean, median, min/max, p25/p75). Forecast range up to 16 days. Only current or future dates are allowed. Data may be limited for locations far from rivers. Provide at least one of: 'location', lat+long, or 'ip'.

`ipgeolocation_lookup`

Look up geolocation data for an IP address, IPv6 address, or hostname. Returns location, network/ASN, currency, timezone and optionally security, dma_code, hostname, abuse contact, and user-agent data. 'ip' field is required — pass the IP or hostname to look up.

`ipgeolocation_bulk_lookup`

Look up geolocation data for up to 50,000 IP addresses or hostnames in one request. Returns an array of geolocation objects — same fields as the single lookup. Individual IP failures include a 'message' field; they don't block other results.

`ip_security_lookup`

IP threat intelligence for a single IP address. Returns a threat score plus VPN, proxy, Tor, residential proxy, relay, bot, spam, known-attacker, and cloud-provider detection.

`ip_security_bulk_lookup`

IP threat intelligence for up to 50,000 IP addresses in one request. Returns an array of threat scores plus VPN, proxy, Tor, residential proxy, relay, bot, spam, known-attacker, and cloud-provider detection for each IP.

`whois_domain_lookup`

Retrieve live WHOIS data for a domain name. Returns registrar details, registrant/admin/technical contacts, name servers, domain status, expiry dates, and raw WHOIS text.

`whois_ip_lookup`

Retrieve live WHOIS ownership and network data for an IPv4 or IPv6 address. Returns network block info, CIDR ranges, organization details, technical/abuse contacts, and raw WHOIS text from the relevant RIR.

`whois_asn_lookup`

Retrieve real-time WHOIS data for an Autonomous System Number. Returns AS name, organization, allocation status, associated CIDR route objects, upstream/downstream/peer ASNs, contact emails, and raw WHOIS text. Accepts the ASN with or without the 'AS' prefix (e.g. 'AS15169' or '15169').Warning: Large ASNs (e.g. major cloud/telecom providers) can return very large responses with thousands of routes and peers, which may consume significant tokens.

`whois_domain_history`

Retrieve historical WHOIS snapshots for a domain, with data going back to 1986. Returns a chronological list of records each containing registrar info, contacts, name servers, and domain status at time of capture.Warning: Long-established domains can return a large number of historical records, which may consume significant tokens.

`whois_reverse_lookup`

Search WHOIS records in reverse to find all domains linked to an owner, email, company, or keyword. Provide exactly one of: keyword, email, owner, or company. keyword uses pattern matching, email supports wildcard regex (e.g. 'm*@gmail.com'), owner and company use full-text phrase matching. Results are paginated. Default mode returns 50 records per page with full WHOIS data; mini mode returns 100 records per page with key fields only.

`whois_bulk_domain_lookup`

Retrieve live WHOIS data for up to 100 domain names. Returns structured registrar info, contacts, name servers, status, and raw WHOIS text per domain. The response is an array under 'bulk_whois_response'. If a single domain fails its entry has status=false while the rest are still returned.

`dns_lookup`

Retrieve real-time DNS records for a hostname or IP address. Supports A, AAAA, MX, NS, SOA, SPF, TXT, and CNAME record types. At least one of host_name or ip_address must be provided. When ip_address is provided, record_types must be ['all'].

`dns_history`

Retrieve historical DNS records for a hostname. Returns paginated snapshots of DNS records captured over time, up to 100 per page. Supports A, AAAA, MX, NS, SOA, SPF, TXT, and CNAME record types.

`dns_reverse`

Find all hostnames associated with a specific DNS record value. Supports reverse IP lookup (all domains on an IP/CIDR), reverse MX lookup (all domains using a mail provider), reverse NS lookup (all domains on a name server), and more. Wildcard patterns using '*' are supported for MX, NS, SOA, SPF, TXT, CNAME. Results are paginated at up to 100 DNS records per page.

`dns_bulk_lookup`

Retrieve real-time DNS records for up to 100 hostnames at once. Supports A, AAAA, MX, NS, SOA, SPF, TXT, and CNAME record types. The response is an array under 'bulk_dns_info'. If a single hostname fails its entry has status=false while the rest are still returned.

`ssl_live_lookup`

Retrieve the live SSL certificate for a domain (end-user/leaf certificate only, no chain). Returns validity dates, serial number, signature algorithm, subject/issuer details, public key info, key usages, Subject Alternative Names, and the PEM-encoded certificate. To retrieve the full certificate chain use 'ssl_live_chain_lookup' instead.

`ssl_live_chain_lookup`

Retrieve the complete live SSL certificate chain for a domain. Includes the leaf certificate plus intermediate and root CA certificates when available. Each certificate includes chain order, validity window, subject and issuer details, public key details, key usages, SAN, and PEM output. To retrieve only the end-user certificate, use 'ssl_live_lookup' instead.

`domain_check_availability`

Check whether a single domain name is available for registration. Returns a boolean 'domainAvailability' field. Use source='whois' for a more authoritative check, source='dns' for a faster one.

`domain_check_availability_with_suggestions`

Check domain name availability and receive alternative domain name suggestions across different TLDs and SLDs if the domain is taken. Returns a 'domain_available_response' array with availability status for the queried domain plus the requested number of suggestions (up to 100).

`domain_bulk_check_availability`

Check domain name availability for up to 100 domains at once. Returns a 'bulk_domain_availability_response' array one result per input domain. Each result includes 'domain', 'domainAvailability' (true/false), and 'status' (true if the check succeeded). Always verify 'status' before trusting 'domainAvailability'.

`screenshot_capture`

Capture a static screenshot of a webpage and return a JSON response containing the screenshot URL which can be downloaded or shared directly. **Always ask the user before calling this tool:** - Full page or just the visible viewport? - Specific element, or the whole page? (If a specific element is needed, help identify the CSS selector via web_fetch on the target URL first.) - Image format: PNG, JPG, WebP, or PDF? - Should ads or cookie banners be blocked for a cleaner result? - Any viewport size / device to simulate? Use `screenshot_capture_scrolling` instead when the user wants a scrolling video/GIF of the page.

`screenshot_capture_scrolling`

Record a scrolling video or animated GIF of a webpage and return a JSON response containing the video download URL. **Always ask the user before calling this tool:** - What format? MP4 (default, best compatibility), WebM (smaller), or GIF (looping animation)? - How long should it scroll — how many seconds (up to 60)? - Scroll speed: slow, normal, or fast? - Should it scroll back to the top after reaching the bottom (great for looping GIFs)? - Any specific viewport size to simulate? Use `screenshot_capture` instead for static screenshots (PNG, JPG, PDF).

`screenshot_bulk_capture`

Capture screenshots of up to 50 webpages in a single request. Returns a JSON response with per-URL results — each entry includes the screenshot download URL, fulfillment status, and any error message. If any URL needs a specific element targeted via CSS selector, use web_fetch on that page first to identify the correct selector before calling this tool. Note: `multiple_scrolling` is NOT supported in bulk mode — for scrolling video captures prefer `screenshot_capture_scrolling` per URL instead.

`user_agent_parse`

Parse a single user-agent string to extract browser, device, OS, and engine details. Also identifies crawlers/bots and flags potential attack user-agents.

`user_agent_bulk_parse`

Parse up to 100 user-agent strings in a single request. Returns an array of parsed objects — same fields as single parse. Individual parse failures include a 'message' field without blocking other results.

`timezone_lookup`

Look up timezone information for a location. Accepts one of: IP address, timezone name, city/address, lat/long, IATA code, ICAO code, or UN/LOCODE. At least one input is required — provide IP if location fields are not provided. Returns current time, UTC offset, DST status, and timezone metadata. Airport/LOCODE inputs also return venue details.

`timezone_convert`

Convert a date/time from one timezone to another. Specify the source and destination timezone each using ONE of: timezone name (tz_from/tz_to), coordinates (lat/long_from + lat/long_to), city address (location_from/location_to), IATA code (iata_from/iata_to), ICAO code (icao_from/icao_to), or UN/LOCODE (locode_from/locode_to).

`astronomy_lookup`

Get astronomy data for a location and date: sunrise/sunset, moon phase, twilight, golden/blue hour, solar noon, moonrise/moonset, and sun/moon position metrics. Provide one of: ip, location, or lat+long. At least one is required. Date format: YYYY-MM-DD (past or future), defaulting to today.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "apifreaks mcp server": {
            "apifreaks": {
                "command": "npx",
                "args": [
                    "-y",
                    "@apifreaks/mcp"
                ],
                "env": {
                    "APIFREAKS_API_KEY": "<YOUR_APIFREAKS_API_KEY>"
                }
            }
        }
    }
}

McpServers

{
    "apifreaks": {
        "command": "npx",
        "args": [
            "-y",
            "@apifreaks/mcp"
        ],
        "env": {
            "APIFREAKS_API_KEY": "<YOUR_APIFREAKS_API_KEY>"
        }
    }
}

@apifreaks/mcp

The official Model Context Protocol (MCP) server for APIFreaks. Add it to Claude, Cursor, Windsurf, or any MCP-compatible client and your AI can instantly query live weather, domains, IPs, DNS records, SSL certs, currency rates, commodity prices, screenshots, and more.

What can you ask once it's connected?

| | |
|---|---|
| 🌦 | "What's the 7-day forecast for Tokyo and should I bring an umbrella?" |
| 🔒 | "Check stripe.com's SSL cert — is it valid and when does it expire?" |
| 🌍 | "Who registered openai.com and when? Has the WHOIS record changed recently?" |
| 💱 | "Convert 2500 USD to EUR, GBP, and JPY at today's live rate." |
| 🔍 | "Check if these 20 domain names are available for registration." |
| 📡 | "What DNS records does github.com have? Show me the full MX and TXT records." |

---

- Requirements
- Environment Variables
- Getting Your API Key
- Quick Start
- Integration Guides
- Claude Code
- Codex CLI
- Claude Desktop
- Cursor
- Windsurf
- Cline
- OpenCode
- Gemini CLI
- VS Code
- Glama
- Available Tools
- Support
- License
- Privacy Policy

---

Requirements

- Node.js v20 or higher
- An APIFreaks API key — sign up free

---

Environment Variables

| Variable | Required | Description |
|---|---|---|
| APIFREAKS_API_KEY | Yes | Your APIFreaks API key — get one at apifreaks.com |

---

Getting Your API Key

Full API documentation: apifreaks.com/docs

---

Quick Start

The fastest way to connect it — via the Claude Code CLI:

claude mcp add apifreaks -e APIFREAKS_API_KEY=your_apikey_here -- npx -y @apifreaks/mcp

That's it. For Cursor, Windsurf, Cline, and others see the Integration Guides below.

---

Integration Guides

Claude Code

Via terminal (recommended):

claude mcp add apifreaks -e APIFREAKS_API_KEY=your_apikey_here -- npx -y @apifreaks/mcp

Via config file (~/.claude/settings.json):

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here"
      }
    }
  }
}

---

Codex CLI

codex mcp add apifreaks --env APIFREAKS_API_KEY=your_apikey_here -- npx -y @apifreaks/mcp

Start a new Codex session after adding the server.

---

Claude Desktop

Edit 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"
      }
    }
  }
}

Restart Claude Desktop after saving.

---

Cursor

Create or edit .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for global):

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here"
      }
    }
  }
}

Or go to Cursor Settings → MCP and add the server via the UI.

---

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here"
      }
    }
  }
}

---

Cline

Open the MCP Servers panel in Cline, click Configure, then Advanced MCP Settings to open cline_mcp_settings.json. Or edit it directly:

- 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"
      }
    }
  }
}

Restart Cline after saving.

---

OpenCode

Edit ~/.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"
      }
    }
  }
}

---

Gemini CLI

Edit ~/.gemini/settings.json (or .gemini/settings.json in your project root for project-level config):

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here"
      }
    }
  }
}

---

VS Code (GitHub Copilot / Continue)

Create .vscode/mcp.json in your workspace:

{
  "servers": {
    "apifreaks": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here"
      }
    }
  }
}

---

Glama

The APIFreaks MCP server is listed on Glama. Glama provides one-click connection and automatic configuration for Claude Desktop and other MCP clients, along with regular security scans and tool quality scoring.

Click Connect on the Glama listing page and follow the prompts — it will generate the correct config for your client automatically.

---

Available Tools

Weather — 8 tools

Real-time conditions, forecasts, historical data, and environmental monitoring.

| Tool | Description |
|---|---|
| weather_current | Current weather for any location — temperature, humidity, wind, pressure, AQI |
| weather_bulk_current | Current weather for up to 50 locations in one request |
| weather_forecast | Forecast up to 16 days ahead with daily, hourly, or minutely precision |
| weather_historical | Historical weather for any past date (data back to 1940) |
| weather_time_series | Historical weather over a custom date range |
| weather_air_quality | Real-time or forecast air quality index and pollutant breakdown |
| weather_marine | Marine and ocean weather, real-time or forecast up to 16 days |
| weather_flood_forecast | Flood forecast with river discharge and flow percentile data |

---

Currency — 10 tools

Live and historical exchange rates for 170+ fiat currencies and 830+ cryptocurrencies.

| Tool | Description |
|---|---|
| currency_latest_rates | Latest exchange rates for all supported currencies |
| currency_historical_rates | Exchange rates for a specific past date |
| currency_latest_converter | Convert an amount between currencies using live rates |
| currency_historical_converter | Convert using rates from a specific past date |
| currency_time_series | Day-by-day exchange rates over a custom date range |
| currency_fluctuation | Rate fluctuation metrics and percentage change over a period |
| currency_geo_convert | Convert to the local currency of an IP address's country |
| currency_supported | Full list of supported currencies with metadata |
| currency_symbols | Map of currency symbols to currency names |
| currency_symbol_info | Validate a currency symbol and get its full name |

---

IP Intelligence — 2 tools

Geolocation, ISP, and network data for any IP address.

| Tool | Description |
|---|---|
| ipgeolocation_lookup | Geolocation data for an IP, IPv6 address, or hostname |
| ipgeolocation_bulk_lookup | Geolocation data for up to 50,000 IPs in one request |

---

WHOIS — 6 tools

Domain and IP ownership data including historical records.

| Tool | Description |
|---|---|
| whois_domain_lookup | Live WHOIS record for a domain name |
| whois_ip_lookup | WHOIS ownership and network data for an IPv4 or IPv6 address |
| whois_asn_lookup | WHOIS data for an Autonomous System Number (ASN) |
| whois_domain_history | Historical WHOIS snapshots for a domain (data back to 1986) |
| whois_reverse_lookup | Search WHOIS records by owner name, email, company, or keyword |
| whois_bulk_domain_lookup | Live WHOIS data for up to 100 domains at once |

---

DNS — 4 tools

Live DNS records, history, and reverse lookups.

| Tool | Description |
|---|---|
| dns_lookup | Real-time DNS records for a hostname — A, AAAA, MX, NS, TXT, CNAME, SOA, SPF |
| dns_history | Historical DNS record snapshots for a hostname |
| dns_reverse | Find all hostnames pointing to a specific DNS record value |
| dns_bulk_lookup | Real-time DNS records for up to 100 hostnames at once |

---

Domain — 3 tools

Domain availability checks with bulk support and suggestions.

| Tool | Description |
|---|---|
| domain_check_availability | Check whether a domain name is available for registration |
| domain_check_availability_with_suggestions | Check availability and get alternative domain suggestions |
| domain_bulk_check_availability | Check availability for up to 100 domains at once |

---

SSL — 2 tools

Live SSL certificate data for any domain.

| Tool | Description |
|---|---|
| ssl_live_lookup | Retrieve the live SSL certificate for a domain |
| ssl_live_chain_lookup | Retrieve the complete SSL certificate chain for a domain |

---

Commodity — 7 tools

Real-time and historical prices for commodities like gold, oil, and agricultural products.

| Tool | Description |
|---|---|
| commodity_symbols | List all supported commodity symbols with metadata |
| commodity_symbol_info | Validate a commodity symbol and get its full details |
| commodity_quotes | List all supported quote currencies for commodity pricing |
| commodity_latest_rates | Real-time prices for one or more commodities |
| commodity_historical_rates | Historical OHLC prices for commodities on a specific date |
| commodity_fluctuation | Price fluctuation metrics over a date range |
| commodity_time_series | Daily OHLC prices over a date range (up to 365 days) |

---

ZIP Code — 7 tools

Postal code lookups, radius searches, and distance calculations worldwide.

| Tool | Description |
|---|---|
| zipcode_lookup | Look up a ZIP or postal code — city, region, country, coordinates |
| zipcode_bulk_lookup | Look up up to 100 ZIP/postal codes at once |
| zipcode_radius_search | Find all ZIP codes within a given radius of a center point |
| zipcode_distance | Calculate distance from a base point to up to 100 ZIP codes |
| zipcode_distance_match | Find all ZIP code pairs within a given distance threshold |
| zipcode_by_city | Get all ZIP/postal codes for a city |
| zipcode_by_region | Get all ZIP/postal codes for a state, province, or region |

---

Timezone — 2 tools

Timezone lookups and conversions using any location identifier.

| Tool | Description |
|---|---|
| timezone_lookup | Timezone info for a location — accepts IP, city, lat/long, IATA, ICAO, or UN/LOCODE |
| timezone_convert | Convert a date and time from one timezone to another |

---

Screenshot — 3 tools

Capture screenshots and scrolling recordings of any webpage.

| Tool | Description |
|---|---|
| screenshot_capture | Capture a screenshot of a webpage and return the image URL |
| screenshot_capture_scrolling | Record a scrolling video or animated GIF of a webpage |
| screenshot_bulk_capture | Capture screenshots of up to 50 webpages in one request |

---

User Agent — 2 tools

Parse user-agent strings to extract browser, OS, and device information.

| Tool | Description |
|---|---|
| user_agent_parse | Parse a user-agent string — browser, device, OS, engine |
| user_agent_bulk_parse | Parse up to 100 user-agent strings in a single request |

---

Astronomy — 1 tool

Solar and lunar data for any location and date.

| Tool | Description |
|---|---|
| astronomy_lookup | Sunrise, sunset, moon phase, twilight, golden hour, solar noon, moonrise, and sun/moon positions |

---

Support

- Email: support@apifreaks.com
- Status: status.apifreaks.com
- Issues: github.com/api-freaks/apifreaks-mcp/issues

---

License

This project is licensed under the Apache License 2.0. You are free to use, modify, and distribute this software in accordance with the terms of the license.

---

Privacy Policy

Your API requests are processed by APIFreaks in accordance with their privacy policy. See apifreaks.com/privacy-policy for details on how data is collected and handled.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

zipcode_lookup

zipcode_bulk_lookup

zipcode_radius_search

zipcode_distance

zipcode_distance_match

zipcode_by_city

zipcode_by_region

commodity_symbols

commodity_symbol_info

commodity_quotes

commodity_latest_rates

commodity_historical_rates

commodity_fluctuation

commodity_time_series

currency_latest_rates

currency_historical_rates

currency_latest_converter

currency_historical_converter

currency_time_series

currency_fluctuation

currency_geo_convert

currency_supported

currency_symbols

currency_symbol_info

weather_current

weather_bulk_current

weather_forecast

weather_historical

weather_time_series

weather_air_quality

weather_marine

weather_flood_forecast

ipgeolocation_lookup

ipgeolocation_bulk_lookup

ip_security_lookup

ip_security_bulk_lookup

whois_domain_lookup

whois_ip_lookup

whois_asn_lookup

whois_domain_history

whois_reverse_lookup

whois_bulk_domain_lookup

dns_lookup

dns_history

dns_reverse

dns_bulk_lookup

ssl_live_lookup

ssl_live_chain_lookup

domain_check_availability

domain_check_availability_with_suggestions

domain_bulk_check_availability

screenshot_capture

screenshot_capture_scrolling

screenshot_bulk_capture

user_agent_parse

user_agent_bulk_parse

timezone_lookup

timezone_convert

astronomy_lookup

Claude Desktop / Cursor

McpServers

@apifreaks/mcp

Table of Contents

Requirements

Environment Variables

Getting Your API Key

Quick Start

Integration Guides

Claude Code

Codex CLI

Claude Desktop

Cursor

Windsurf

Cline

OpenCode

`zipcode_lookup`

`zipcode_bulk_lookup`

`zipcode_radius_search`

`zipcode_distance`

`zipcode_distance_match`

`zipcode_by_city`

`zipcode_by_region`

`commodity_symbols`

`commodity_symbol_info`

`commodity_quotes`

`commodity_latest_rates`

`commodity_historical_rates`

`commodity_fluctuation`

`commodity_time_series`

`currency_latest_rates`

`currency_historical_rates`

`currency_latest_converter`

`currency_historical_converter`

`currency_time_series`

`currency_fluctuation`

`currency_geo_convert`

`currency_supported`

`currency_symbols`

`currency_symbol_info`

`weather_current`

`weather_bulk_current`

`weather_forecast`

`weather_historical`

`weather_time_series`

`weather_air_quality`

`weather_marine`

`weather_flood_forecast`

`ipgeolocation_lookup`

`ipgeolocation_bulk_lookup`

`ip_security_lookup`

`ip_security_bulk_lookup`

`whois_domain_lookup`

`whois_ip_lookup`

`whois_asn_lookup`

`whois_domain_history`

`whois_reverse_lookup`

`whois_bulk_domain_lookup`

`dns_lookup`

`dns_history`

`dns_reverse`

`dns_bulk_lookup`

`ssl_live_lookup`

`ssl_live_chain_lookup`

`domain_check_availability`

`domain_check_availability_with_suggestions`

`domain_bulk_check_availability`

`screenshot_capture`

`screenshot_capture_scrolling`

`screenshot_bulk_capture`

`user_agent_parse`

`user_agent_bulk_parse`

`timezone_lookup`

`timezone_convert`

`astronomy_lookup`