APIFreaks MCP

@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 query live weather, WHOIS, DNS, SSL, domain availability / reputation / typosquatting, IP geolocation and threat intel, currency, commodities, screenshots, PDFs, VAT/IBAN/SWIFT, email validation, disposable-email checks, 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 v20 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 need.

Set ENABLE_MODULES in your MCP client config. Only those modules are registered. If it is missing or empty, only list_modules is available — call it to see every module and a paste-ready ENABLE_MODULES=... line (keep existing modules, append new ones), then restart.

ENABLE_MODULES=ip-intelligence,whois,dns,domain,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 ENABLE_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 ENABLE_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", "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather" } } } }

Codex CLI

codex mcp add apifreaks --env APIFREAKS_API_KEY=your_apikey_here --env ENABLE_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", "ENABLE_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", "ENABLE_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", "ENABLE_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", "ENABLE_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", "ENABLE_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", "ENABLE_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", "ENABLE_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

list_modules (always available)

Module catalog for opt-in ENABLE_MODULES. Call when a capability is missing from the tool list or to check coverage. Live tools already appear in tools/list; use needs_enable[].enable_line for a paste-ready config line, then restart.

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, hist