Apifreaks MCP Server

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

What can you ask once it's connected?

---

Table of Contents

• Requirements
• Environment Variables
• Modules
• 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 v24 or higher
• An APIFreaks API key — sign up free

---

Environment Variables

---

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.

---

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.

---

Geocoding (geocoding) — 2 tools

Address ↔ coordinate conversion.

---

WHOIS (whois) — 6 tools

Domain and IP ownership data including historical records.

---

DNS (dns) — 4 tools

Live DNS records, history, and reverse lookups.

---

Scraper (scraper) — 2 tools

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

---

Email Validation (email-validation) — 2 tools

Deliverability, syntax, domain, and optional IP enrichment.

---

Phone Validation (phone-validation) — 2 tools

Carrier, line type, location, and standardized formats.

---

SSL (ssl) — 2 tools

Live SSL certificate data for any domain.

---

Domain (domain) — 4 tools

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

---

Screenshot (screenshot) — 3 tools

Capture screenshots and scrolling recordings of any 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.

---

Currency (currency) — 12 tools

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

---

Commodity (commodity) — 7 tools

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

---

Financial (financial) — 9 tools

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

---

ZIP Code (zipcode) — 7 tools

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

---

Weather (weather) — 9 tools

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

---

Geography (geography) — 10 tools

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

---

Timezone (timezone) — 2 tools

Timezone lookups and conversions using any location identifier.

---

User Agent (user-agent) — 2 tools

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

---

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.