@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, and more.

What can you ask once it's connected?

Table of Contents

• Requirements
• Environment Variables
• 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

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 -- npx -y @apifreaks/mcp

That's it. 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 -- 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"
      }
    }
  }
}

Codex CLI

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

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"
      }
    }
  }
}

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"
      }
    }
  }
}

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"
      }
    }
  }
}

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"
      }
    }
  }
}

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"
      }
    }
  }
}

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"
      }
    }
  }
}

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

Weather — 8 tools

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

Currency — 10 tools

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

IP Intelligence — 4 tools

Geolocation, ISP, network, and threat data for any IP address.

WHOIS — 6 tools

Domain and IP ownership data including historical records.

DNS — 4 tools

Live DNS records, history, and reverse lookups.

Domain — 3 tools

Domain availability checks with bulk support and suggestions.

SSL — 2 tools

Live SSL certificate data for any domain.

Commodity — 7 tools

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

ZIP Code — 7 tools

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

Timezone — 2 tools

Timezone lookups and conversions using any location identifier.

Screenshot — 3 tools

Capture screenshots and scrolling recordings of any webpage.

User Agent — 2 tools

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

Astronomy — 1 tool

Solar and lunar data for any location and date.

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.