@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 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
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.
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:
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):
Via config file (~/.claude/settings.json):
Codex CLI
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
Restart Claude Desktop after saving.
Cursor
Create or edit .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for global):
Or go to Cursor Settings → MCP and add the server via the UI.
Windsurf
Edit ~/.codeium/windsurf/mcp_config.json:
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
Restart Cline after saving.
OpenCode
Edit ~/.config/opencode/config.json:
Gemini CLI
Edit ~/.gemini/settings.json (or .gemini/settings.json in your project root for project-level config):
VS Code (GitHub Copilot / Continue)
Create .vscode/mcp.json in your workspace:
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, 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) — 4 tools
Deliverability, syntax, domain, optional IP enrichment, and disposable-provider checks.
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) — 6 tools
Domain availability checks with bulk support, suggestions, subdomain discovery, reputation assessment, and typosquatting search.
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) — 8 tools
Real-time, historical, and intraday prices for 520+ commodities across metals, energy, agriculture, and more. On the multi-symbol endpoints, symbols that cannot be resolved come back in an unresolved map while the rest of the request still succeeds. Intraday rates take exactly one symbol.
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
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.