APIFreaks MCP Server

The official Model Context Protocol (MCP) server for APIFreaks. Add it to Claude, Cursor, Windsurf, or any MCP-compatible client and your AI can query live weather, WHOIS, DNS, SSL, domain…

Local serverstdioApache-2.0

What is the APIFreaks MCP Server?

Apifreaks Mcp Server is an MCP project maintained in the api-freaks/apifreaks-mcp repository. The maintainer describes its purpose as “The official Model Context Protocol (MCP) server for APIFreaks. Add it to Claude, Cursor, Windsurf, or any MCP-compatible client and your AI can query live…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @apifreaks/mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares APIFREAKS_API_KEY, ENABLE_MODULES. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
ipgeolocation_lookupLocation, ASN, company, currency, timezone for an IP or hostname
ipgeolocation_bulk_lookupSame geolocation data for up to 50,000 IPs in one request
ip_security_lookupThreat score plus VPN/proxy/Tor/bot/spam/cloud/gateway signals for one IP
ip_security_bulk_lookupSame threat intelligence for up to 50,000 IPs in one request
geocode_forwardConvert an address or place name into coordinates
geocode_reverseConvert coordinates into a street address
whois_domain_lookupLive WHOIS record for a domain name
whois_ip_lookupWHOIS ownership and network data for an IPv4 or IPv6 address
whois_asn_lookupWHOIS data for an Autonomous System Number (ASN)
whois_domain_historyHistorical WHOIS snapshots for a domain (data back to 1986)
whois_reverse_lookupSearch WHOIS records by owner name, email, company, or keyword
whois_bulk_domain_lookupLive WHOIS data for up to 100 domains at once
dns_lookupReal-time DNS records for a hostname — A, AAAA, MX, NS, TXT, CNAME, SOA, SPF
dns_historyHistorical DNS record snapshots for a hostname
dns_reverseFind all hostnames pointing to a specific DNS record value
dns_bulk_lookupReal-time DNS records for up to 100 hostnames at once
scraper_scrapeScrape static HTML (optional extract / form submit). Empty instructions return the full page
scraper_scrape_jsScrape with JavaScript rendering, browser steps, proxies, and optional CAPTCHA solving
email_validateValidate a single email address
email_bulk_validateValidate up to 10 email addresses in one request
phone_validateValidate a single phone number
phone_bulk_validateValidate up to 100 phone numbers in one request
ssl_live_lookupRetrieve the live SSL certificate for a domain
ssl_live_chain_lookupRetrieve the complete SSL certificate chain for a domain
domain_check_availabilityCheck whether a domain name is available for registration
domain_check_availability_with_suggestionsCheck availability and get alternative domain suggestions
domain_subdomain_lookupPaginated list of discovered subdomains for a domain
domain_bulk_check_availabilityCheck availability for up to 100 domains at once
domain_reputation_lookupRisk verdict, trust score, DGA, threat feeds, and email deliverability for a domain
domain_typosquatting_lookupFind registered typo/look-alike domains for a brand keyword or wildcard pattern
screenshot_captureCapture a screenshot of a webpage and return the image URL
screenshot_bulk_captureCapture screenshots of up to 50 webpages in one request
screenshot_capture_scrollingRecord a scrolling video or animated GIF of a webpage
pdf_mergeMerge PDFs (local paths and/or stored file IDs)
pdf_splitSplit a PDF by page ranges
pdf_extract_pagesExtract pages into a new PDF or ZIP
pdf_remove_pagesRemove pages from a PDF
pdf_to_imageConvert pages to PNG, JPG, TIFF, BMP, or GIF
pdf_generateRender a template with JSON and get a hosted PDF URL
pdf_generate_bulkRender one PDF per CSV row
pdf_compressReduce PDF file size
pdf_rotateRotate pages
pdf_encryptPassword-protect a PDF
pdf_restrictRestrict printing, copying, and editing
pdf_decryptRemove encryption
pdf_unrestrictRemove permission restrictions
pdf_linearizeLinearize for Fast Web View
pdf_task_statusCheck one async job (queued / processing / completed / failed)
pdf_file_statusMetadata for a stored file
pdf_filesList stored PDFs
pdf_file_deleteDelete a stored PDF
pdf_uploadUpload local PDFs and get file IDs
pdf_upload_binaryUpload one large PDF as raw bytes and get a file ID
currency_latest_ratesLatest exchange rates for all supported currencies
currency_historical_ratesExchange rates for a specific past date
currency_latest_converterConvert an amount between currencies using live rates
currency_historical_converterConvert using rates from a specific past date
currency_time_seriesDay-by-day exchange rates over a custom date range
currency_fluctuationRate fluctuation metrics and percentage change over a period
currency_geo_convertConvert to the local currency of an IP address's country
currency_supportedFull list of supported currencies with metadata
currency_symbolsMap of currency symbols to currency names
currency_symbol_infoValidate a currency symbol and get its full name
currency_historical_data_limitsHistorical data availability window for every currency
currency_historical_data_limit_infoHistorical data availability window for one currency code
commodity_latest_ratesLatest prices (per-symbol updateInterval), optionally converted to a quote currency
commodity_historical_ratesHistorical OHLC prices for a specific date (from 1990; falls back to last available earlier date)
commodity_fluctuationStart/end price, absolute change, and percent change over a date range (no range-length limit)
commodity_time_seriesDaily OHLC prices over a date range (up to 365 days; non-trading days excluded)
commodity_symbolsList all supported commodity symbols with metadata, including each symbol's updateInterval
commodity_symbol_infoLook up one symbol (refresh cadence, status, unit, currency)
commodity_quotesList all supported quote currencies for commodity pricing
financial_vat_rates_by_countryVAT rates for a country, optionally by state
financial_vat_rates_bulkVAT rates for up to 100 countries/states
financial_vat_rates_by_ipVAT rates for the country resolved from an IP address
financial_vat_validateValidate an EU (VIES) or UK (HMRC) VAT number
financial_iban_validateValidate an IBAN (format, checksum, bank/SEPA metadata)
financial_swift_lookupBank details for an 8- or 11-character SWIFT/BIC code
financial_swift_finderDrill down country → bank → city → SWIFT/BIC codes
financial_supported_countriesCountries (and VAT states) supported by VAT, IBAN, and SWIFT APIs
financial_supported_country_infoCheck whether one country is supported by VAT, IBAN, and/or SWIFT
zipcode_lookupLook up a ZIP or postal code — city, region, country, coordinates
zipcode_radius_searchFind all ZIP codes within a given radius of a center point
zipcode_distanceCalculate distance from a base point to up to 100 ZIP codes
zipcode_by_cityGet all ZIP/postal codes for a city
zipcode_bulk_lookupLook up up to 100 ZIP/postal codes at once
zipcode_distance_matchFind all ZIP code pairs within a given distance threshold
zipcode_by_regionGet all ZIP/postal codes for a state, province, or region
weather_currentCurrent weather for any location — temperature, humidity, wind, pressure, AQI
weather_forecastForecast up to 16 days ahead with daily, hourly, or minutely precision
weather_historicalHistorical weather for any past date (data back to 1940)
weather_time_seriesHistorical weather over a custom date range
weather_air_qualityReal-time or forecast air quality index and pollutant breakdown
weather_marineMarine and ocean weather, real-time or forecast up to 16 days
weather_flood_forecastFlood forecast with river discharge and flow percentile data
weather_bulk_currentCurrent weather for up to 50 locations in one request
astronomy_lookupSunrise, sunset, moon phase, twilight, golden hour, solar noon, moonrise, and sun/moon positions
geodb_admin_levelsAdministrative level types for a country
geodb_admin_unitsStates, provinces, and other admin units for a country
geodb_admin_unit_detailsDetails for one administrative unit
geodb_countriesList countries with ISO codes, capitals, and regions
geodb_country_detailsFull metadata for one country by alpha-2 code
geodb_citiesCities for a country, optionally filtered by admin unit
geodb_regionsList GeoDB regions (Africa, Americas, Asia, Europe, Oceania, Polar)
geodb_subregionsList subregions, optionally filtered by region
geodb_flags_supportedSupported country and organization flag identifiers
geodb_flagRetrieve a country or organization flag image
timezone_lookupTimezone info for a location — accepts IP, city, lat/long, IATA, ICAO, or UN/LOCODE
timezone_convertConvert a date and time from one timezone to another
user_agent_parseParse a user-agent string — browser, device, OS, engine
user_agent_bulk_parseParse up to 20,000 user-agent strings in a single request

How to install the APIFreaks MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
APIFREAKS_API_KEYDeclared in the maintainer’s client configuration.Check documentation
ENABLE_MODULESDeclared in the maintainer’s client configuration.Check documentation