Skip to main content
Glama

@apifreaks/mcp

npm version GitHub release Glama Node.js CI License

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, PDFs, web scrapes, VAT/IBAN/SWIFT, email and phone validation, geocoding, 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."


Table of Contents


Related MCP server: Weather MCP Server

Requirements


Environment Variables

Variable

Required

Description

APIFREAKS_API_KEY

Yes

Your APIFreaks API key — get one at apifreaks.com

APIFREAKS_MODULES

Yes

Comma-separated list of modules to expose. If unset or empty, only list_modules is listed (no API tools). See Modules.


Modules

This server covers many APIs. Advertising all of them in tools/list would fill the client's context window, so you opt in to the modules you actually need.

Set APIFREAKS_MODULES in your MCP client config. Only those modules are registered, so tools/list returns just that subset. If the variable is missing or empty, no API tools are listed — only list_modules. Call it to see each module and the tools inside it, then paste a full APIFREAKS_MODULES=... line (every module you want, not only the new name) and restart.

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

Hyphens and underscores are interchangeable (user-agent and user_agent both work). Unknown names are ignored and logged to stderr.

Module

Tools

ip-intelligence

IP geolocation and threat intelligence (single + bulk)

geocoding

Forward and reverse geocoding

whois

Domain, IP, ASN, history, reverse, bulk

dns

Live lookup, history, reverse, bulk

scraper

Static HTML scrape and JS-rendered scrape

email-validation

Single and bulk email validation

phone-validation

Single and bulk phone validation

ssl

Live certificate and full chain

domain

Availability checks, suggestions, bulk, subdomain lookup

screenshot

Capture, scrolling capture, bulk

pdf

Merge, split, compress, protect, generate, convert

currency

Live/historical rates, converters, time series, symbols, limits

commodity

Live/historical prices, fluctuation, time series, symbols

financial

VAT rates, VAT numbers, IBAN, SWIFT/BIC

zipcode

Lookup, radius, distance, city/region

weather

Current, forecast, historical, air quality, marine, flood, astronomy

geography

Admin units, countries, cities, regions, flags

timezone

Lookup and convert

user-agent

Parse single or bulk user-agent strings


Getting Your API Key

Sign in or create a free account at apifreaks.com. Your API key is in the dashboard under API Keys.

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 -e APIFREAKS_MODULES=ip-intelligence,currency,whois,dns,weather -- npx -y @apifreaks/mcp

Replace ip-intelligence,currency,whois,dns,weather with the modules you need. 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 -e APIFREAKS_MODULES=ip-intelligence,currency,whois,dns,weather -- 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",
        "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

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",
        "APIFREAKS_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

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",
        "APIFREAKS_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

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",
        "APIFREAKS_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

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",
        "APIFREAKS_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

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",
        "APIFREAKS_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

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",
        "APIFREAKS_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

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",
        "APIFREAKS_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

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

IP Intelligence (ip-intelligence) — 4 tools

Geolocation, ISP, network, and threat 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

ip_security_lookup

Threat score, VPN/proxy/Tor/bot detection for a single IP

ip_security_bulk_lookup

Threat intelligence for up to 50,000 IPs in one request


Geocoding (geocoding) — 2 tools

Address ↔ coordinate conversion.

Tool

Description

geocode_forward

Convert an address or place name into coordinates

geocode_reverse

Convert coordinates into a street address


WHOIS (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 (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


Scraper (scraper) — 2 tools

Extract HTML or structured fields from a URL. Static mode first; JS rendering only when the page needs a browser.

Tool

Description

scraper_scrape

Scrape static HTML (optional extract / form submit). Empty instructions return the full page

scraper_scrape_js

Scrape with JavaScript rendering, browser steps, proxies, and optional CAPTCHA solving


Email Validation (email-validation) — 2 tools

Deliverability, syntax, domain, and optional IP enrichment.

Tool

Description

email_validate

Validate a single email address

email_bulk_validate

Validate up to 100 email addresses in one request


Phone Validation (phone-validation) — 2 tools

Carrier, line type, location, and standardized formats.

Tool

Description

phone_validate

Validate a single phone number

phone_bulk_validate

Validate up to 100 phone numbers in one request


SSL (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


Domain (domain) — 4 tools

Domain availability checks with bulk support, suggestions, and subdomain discovery.

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_subdomain_lookup

Paginated list of discovered subdomains for a domain

domain_bulk_check_availability

Check availability for up to 100 domains at once


Screenshot (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_bulk_capture

Capture screenshots of up to 50 webpages in one request

screenshot_capture_scrolling

Record a scrolling video or animated GIF of a webpage


PDF (pdf) — 20 tools

Merge, split, extract or remove pages, convert to images, generate from templates, compress, rotate, encrypt/restrict, decrypt/unrestrict, and linearize.

Jobs (merge, split, convert, …) are asynchronous: they return a taskId. Check progress with pdf_task_status. Local files need an absolute path (the MCP server reads the disk). You can also pass a stored file_id. Template generation (pdf_generate, pdf_generate_bulk) is synchronous and returns a hosted pdf_url.

Completed jobs include download URLs. Add your API key as the apiKey query parameter or the X-apiKey header.

Tool

Description

pdf_merge

Merge PDFs (local paths and/or stored file IDs)

pdf_split

Split a PDF by page ranges

pdf_extract_pages

Extract pages into a new PDF or ZIP

pdf_remove_pages

Remove pages from a PDF

pdf_to_image

Convert pages to PNG, JPG, TIFF, BMP, or GIF

pdf_generate

Render a template with JSON and get a hosted PDF URL

pdf_generate_bulk

Render one PDF per CSV row

pdf_compress

Reduce PDF file size

pdf_rotate

Rotate pages

pdf_encrypt

Password-protect a PDF

pdf_restrict

Restrict printing, copying, and editing

pdf_decrypt

Remove encryption

pdf_unrestrict

Remove permission restrictions

pdf_linearize

Linearize for Fast Web View

pdf_task_status

Check one async job (queued / processing / completed / failed)

pdf_file_status

Metadata for a stored file

pdf_files

List stored PDFs

pdf_file_delete

Delete a stored PDF

pdf_upload

Upload local PDFs and get file IDs

pdf_upload_binary

Upload one large PDF as raw bytes and get a file ID


Currency (currency) — 12 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

currency_historical_data_limits

Historical data availability window for every currency

currency_historical_data_limit_info

Historical data availability window for one currency code


Commodity (commodity) — 7 tools

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

Tool

Description

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)

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


Financial (financial) — 9 tools

VAT rates, VAT-number checks, IBAN validation, and SWIFT/BIC lookup.

Tool

Description

financial_vat_rates_by_country

VAT rates for a country, optionally by state

financial_vat_rates_bulk

VAT rates for up to 100 countries/states

financial_vat_rates_by_ip

VAT rates for the country resolved from an IP address

financial_vat_validate

Validate an EU (VIES) or UK (HMRC) VAT number

financial_iban_validate

Validate an IBAN (format, checksum, bank/SEPA metadata)

financial_swift_lookup

Bank details for an 8- or 11-character SWIFT/BIC code

financial_swift_finder

Drill down country → bank → city → SWIFT/BIC codes

financial_supported_countries

Countries (and VAT states) supported by VAT, IBAN, and SWIFT APIs

financial_supported_country_info

Check whether one country is supported by VAT, IBAN, and/or SWIFT


ZIP Code (zipcode) — 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_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_by_city

Get all ZIP/postal codes for a city

zipcode_bulk_lookup

Look up up to 100 ZIP/postal codes at once

zipcode_distance_match

Find all ZIP code pairs within a given distance threshold

zipcode_by_region

Get all ZIP/postal codes for a state, province, or region


Weather (weather) — 9 tools

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

Tool

Description

weather_current

Current weather for any location — temperature, humidity, wind, pressure, AQI

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

weather_bulk_current

Current weather for up to 50 locations in one request

astronomy_lookup

Sunrise, sunset, moon phase, twilight, golden hour, solar noon, moonrise, and sun/moon positions


Geography (geography) — 10 tools

Countries, cities, administrative units, regions, and flag images.

Tool

Description

geodb_admin_levels

Administrative level types for a country

geodb_admin_units

States, provinces, and other admin units for a country

geodb_admin_unit_details

Details for one administrative unit

geodb_countries

List countries with ISO codes, capitals, and regions

geodb_country_details

Full metadata for one country by alpha-2 code

geodb_cities

Cities for a country, optionally filtered by admin unit

geodb_regions

List GeoDB regions (Africa, Americas, Asia, Europe, Oceania, Polar)

geodb_subregions

List subregions, optionally filtered by region

geodb_flags_supported

Supported country and organization flag identifiers

geodb_flag

Retrieve a country or organization flag image


Timezone (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


User Agent (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


Support


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.

A
license - permissive license
A
quality
A
maintenance

Maintenance

Maintainers
Response time
2wRelease cycle
7Releases (12mo)
Commit activity

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
  • F
    license
    Not graded
    quality
    D
    maintenance
    Exposes public weather and climate data through a standardized API, allowing AI agents to retrieve current conditions, 7-day forecasts, and historical data. It enables weather-aware automation and data enrichment for conversational agents and travel planning.

View all related MCP servers

Related MCP Connectors

  • Live & historical FX rates and currency conversion for AI agents. No API keys.

  • US weather & geo for AI agents: forecasts, alerts, earthquakes, elevation, geocoding. No keys.

  • US weather, alerts, earthquakes and elevation for AI agents, from NWS/NOAA and USGS. No API keys.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/api-freaks/apifreaks-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server