Installation

Install the APIFreaks MCP Server

Pick how you want to connect, then open your client. Every setup below follows the method you pick.

Choose a connection method

Both methods use the same API key and the same credits. Not sure? Start with Remote, which has nothing to install. Pick Local if you'd rather run the server on your own machine, or want to work with files on your computer, like PDFs. The overview explains both.

Modules

This server covers many APIs. Advertising all of them in tools/list would fill your client's context window, so you opt in to the modules you actually need. Set ENABLE_MODULES in your MCP client config and 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 ENABLE_MODULES=... line - every module you want, not only the new name - and restart your client.

ENABLE_MODULES

1ENABLE_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 validation, single and bulk disposable checks
`phone-validation`	Single and bulk phone validation
`ssl`	Live certificate and full chain
`domain`	Availability, suggestions, bulk, subdomain, reputation, typosquatting
`screenshot`	Capture, scrolling capture, bulk
`pdf`	Merge, split, compress, protect, generate, convert
`currency`	Live/historical rates, converters, time series, symbols, limits
`commodity`	Live/historical/intraday prices (520+), 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

Full API reference: APIFreaks Docs.

Choose your client

Open the app you use to see its Remote (HTTP) setup.

Claude

Web and desktop app

Before you start

An APIFreaks API key from your dashboard
A Claude account. On Team and Enterprise plans, an owner adds the connector first (see the callout below).

1
Add the connector
In Claude, open Customize > Connectors. Click Add, then Add custom connector. Enter the name APIFreaks and the URL below, click Continue, then click Add.
Server URL
1https://mcp.apifreaks.com/mcp
2
Sign in
Click Connect. An APIFreaks page opens. Paste your API key and click Connect.
3
Turn it on in a chat
Click + in the chat box, open Connectors, and switch APIFreaks on.

On a Team or Enterprise plan

An owner adds the connector once in Organization settings > Connectors > Add > Custom > Web, with the same name and URL. Each member then finds APIFreaks under Customize > Connectors, clicks Connect, and signs in with their own key.

Verify the connection

APIFreaks shows as connected under Customize > Connectors.
Ask: "Who owns the domain apple.com?"

Claude Code

Terminal agent

Before you start

An APIFreaks API key from your dashboard
Claude Code installed

1
Add the server
Run one command. Add --scope user after add to use the server in every project.
terminal
1claude mcp add --transport http apifreaks https://mcp.apifreaks.com/mcp
2
Sign in
Start Claude Code and run /mcp. Select apifreaks and follow the sign-in. An APIFreaks page opens in your browser. Paste your API key and click Connect.
3
Or share it with your team
Add this to .mcp.json in your project root. Each person signs in with their own key through /mcp.
.mcp.json
1{
2 "mcpServers": {
3 "apifreaks": {
4 "type": "http",
5 "url": "https://mcp.apifreaks.com/mcp"
6 }
7 }
8}

Prefer an API key header?

Add --header "Authorization: Bearer your_apikey_here" to the command in step 1. Claude Code then uses your key directly and skips the sign-in.

Verify the connection

Run /mcp and look for apifreaks with a connected status.
Ask: "List the APIFreaks tools you can use."

Cursor

AI editor

Before you start

An APIFreaks API key from your dashboard

1
Create the config file
Use .cursor/mcp.json in your project, or ~/.cursor/mcp.json for every project.
.cursor/mcp.json
1{
2 "mcpServers": {
3 "apifreaks": {
4 "url": "https://mcp.apifreaks.com/mcp"
5 }
6 }
7}
2
Restart Cursor and sign in
Save the file, then quit Cursor and open it again. When Cursor asks you to sign in to apifreaks, an APIFreaks page opens in your browser. Paste your API key and click Connect.
3
Or use your API key instead
To skip the sign-in, add your key as a header and restart Cursor.
.cursor/mcp.json
1{
2 "mcpServers": {
3 "apifreaks": {
4 "url": "https://mcp.apifreaks.com/mcp",
5 "headers": {
6 "Authorization": "Bearer your_apikey_here"
7 }
8 }
9 }
10}

Keep your key out of shared files

If you use the header in a shared project, write "Bearer ${env:APIFREAKS_API_KEY}" and set APIFREAKS_API_KEY in your environment.

Verify the connection

In Cursor Settings, apifreaks shows in the MCP list as enabled, with its tools listed.
Ask in Agent mode: "What are the MX and NS records for github.com?"

VS Code

Editor with Copilot

Before you start

An APIFreaks API key from your dashboard
GitHub Copilot set up in VS Code

1
Add the server
Add this to ~/.copilot/mcp-config.json to use the server in every workspace.
~/.copilot/mcp-config.json
1{
2 "mcpServers": {
3 "apifreaks": {
4 "type": "http",
5 "url": "https://mcp.apifreaks.com/mcp",
6 "tools": ["*"]
7 }
8 }
9}
2
Start the server and sign in
Run Chat: Open Customizations from the Command Palette and open MCP Servers. Start apifreaks, then click Authenticate when it appears. An APIFreaks page opens in your browser. Paste your API key and click Connect.
3
Or use your API key instead
To skip the sign-in, add your key as a header.
~/.copilot/mcp-config.json
1{
2 "mcpServers": {
3 "apifreaks": {
4 "type": "http",
5 "url": "https://mcp.apifreaks.com/mcp",
6 "headers": {
7 "Authorization": "Bearer your_apikey_here"
8 },
9 "tools": ["*"]
10 }
11 }
12}

Sharing with your team

Put the block in .mcp.json at your workspace root. With sign-in, each person signs in with their own key. With the header, use ${APIFREAKS_API_KEY} in place of your key so each person's key comes from their own environment.

Verify the connection

apifreaks is listed and running under MCP Servers.
Ask Copilot in agent mode: "What is the standard VAT rate in Germany?"

Windsurf

AI editor

Before you start

An APIFreaks API key from your dashboard

1
Edit the config file
Open ~/.codeium/windsurf/mcp_config.json and add the entry.
~/.codeium/windsurf/mcp_config.json
1{
2 "mcpServers": {
3 "apifreaks": {
4 "serverUrl": "https://mcp.apifreaks.com/mcp"
5 }
6 }
7}
2
Refresh and sign in
In Cascade, open the MCP panel and press refresh. When Windsurf asks you to sign in to apifreaks, an APIFreaks page opens in your browser. Paste your API key and click Connect.
3
Or use your API key instead
To skip the sign-in, add your key as a header and refresh the MCP panel again.
~/.codeium/windsurf/mcp_config.json
1{
2 "mcpServers": {
3 "apifreaks": {
4 "serverUrl": "https://mcp.apifreaks.com/mcp",
5 "headers": {
6 "Authorization": "Bearer your_apikey_here"
7 }
8 }
9 }
10}

Verify the connection

apifreaks appears in the MCP panel with its tools.

Codex CLI

Terminal agent

Before you start

An APIFreaks API key from your dashboard

1
Add the server
terminal
1codex mcp add apifreaks --url https://mcp.apifreaks.com/mcp
2
Sign in
Codex starts the sign-in as soon as the server is added. An APIFreaks page opens in your browser. Paste your API key and click Connect. To sign in again later, run codex mcp login apifreaks.
3
Or use your API key instead
To skip the sign-in, Codex can read your key from an environment variable. Add the export line to your shell profile so it's set every time.
terminal
1export APIFREAKS_API_KEY=your_apikey_here
2codex mcp add apifreaks --url https://mcp.apifreaks.com/mcp --bearer-token-env-var APIFREAKS_API_KEY

Start a new session

Codex loads servers when a session starts, so open a fresh one after adding the server.

Verify the connection

Run codex mcp list and confirm apifreaks is listed.
In a session, run /mcp and confirm it's active.

Gemini CLI

Terminal agent

Before you start

An APIFreaks API key from your dashboard

1
Add the server
terminal
1gemini mcp add -s user --transport http apifreaks https://mcp.apifreaks.com/mcp
2
Sign in
Start Gemini CLI and run /mcp auth apifreaks. An APIFreaks page opens in your browser. Paste your API key and click Connect.
3
Or use your API key instead
To skip the sign-in, add the server with your key as a header.
terminal
1gemini mcp add -s user --transport http --header "Authorization: Bearer your_apikey_here" apifreaks https://mcp.apifreaks.com/mcp

/mcp auth opens a browser on the machine running Gemini CLI, so it won't work over a remote SSH session. Use your API key there instead.

Verify the connection

Run /mcp list and confirm apifreaks is connected.

Cline

VS Code extension

Before you start

An APIFreaks API key from your dashboard

1
Open the settings file
In Cline, open the MCP Servers panel, click Configure, then Configure MCP Servers. This opens cline_mcp_settings.json.
2
Add the server
cline_mcp_settings.json
1{
2 "mcpServers": {
3 "apifreaks": {
4 "type": "streamableHttp",
5 "url": "https://mcp.apifreaks.com/mcp",
6 "disabled": false,
7 "autoApprove": []
8 }
9 }
10}
3
Sign in
In the MCP Servers panel, click Authenticate next to apifreaks. An APIFreaks page opens in your browser. Paste your API key and click Connect.
4
Or use your API key instead
To skip the sign-in, add "headers": { "Authorization": "Bearer your_apikey_here" } to the apifreaks entry and save the file.

Keep the type setting

Cline needs "type": "streamableHttp" for this server. Without it, Cline tries an older connection type and the server won't connect.

Verify the connection

apifreaks is listed in the MCP Servers panel and turned on.
If it doesn't show up, restart Cline.

OpenCode

Terminal agent

Before you start

An APIFreaks API key from your dashboard

1
Edit the config file
Open ~/.config/opencode/opencode.json and add the entry.
~/.config/opencode/opencode.json
1{
2 "$schema": "https://opencode.ai/config.json",
3 "mcp": {
4 "apifreaks": {
5 "type": "remote",
6 "url": "https://mcp.apifreaks.com/mcp",
7 "enabled": true
8 }
9 }
10}
2
Sign in
Run this, and an APIFreaks page opens in your browser. Paste your API key and click Connect.
terminal
1opencode mcp auth apifreaks
3
Or use your API key instead
To skip the sign-in, add "oauth": false and "headers": { "Authorization": "Bearer your_apikey_here" } to the apifreaks entry, then restart OpenCode.

Verify the connection

Run opencode mcp list and confirm apifreaks is connected.

Using another client?

Any client that supports remote MCP servers over Streamable HTTP can connect. Point it at https://mcp.apifreaks.com/mcp, then sign in with OAuth or add the header Authorization: Bearer your_apikey_here.

Choose your client

Open the app you use to see its Local (stdio) setup.

Claude Code

Terminal agent

Before you start

Node.js 20 or higher (check with node -v)
An APIFreaks API key from your dashboard
A list of modules to enable, such as ip-intelligence,whois,dns

1
Add the server
Run one command. It registers the server with your key and modules. Add --scope user after add to use it in every project.
terminal
1claude mcp add apifreaks -e APIFREAKS_API_KEY=your_apikey_here -e ENABLE_MODULES=ip-intelligence,currency,whois,dns,weather -- npx -y @apifreaks/mcp
2
Or edit the config file
Prefer a file? Add the same entry to .mcp.json in your project root. Everyone on the project gets the server.
.mcp.json
1{
2 "mcpServers": {
3 "apifreaks": {
4 "command": "npx",
5 "args": ["-y", "@apifreaks/mcp"],
6 "env": {
7 "APIFREAKS_API_KEY": "your_apikey_here",
8 "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
9 }
10 }
11 }
12}
3
Start a new session
Servers load when a session starts, so open a fresh one.

Choose your modules

ENABLE_MODULES controls which tools your client loads. If it's empty, only list_modules is listed. Every module ID is in the Modules section above.

Verify the connection

Run /mcp and look for apifreaks with a connected status.
Ask: "List the APIFreaks modules you can use."

Claude Desktop

Desktop app

Before you start

Node.js 20 or higher (check with node -v)
An APIFreaks API key from your dashboard
A list of modules to enable, such as ip-intelligence,whois,dns

1
Open the config file
In Claude Desktop, open Settings, then Developer, then Edit Config. On macOS the file is ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows it's %APPDATA%\Claude\claude_desktop_config.json.
2
Add the server
Paste this entry, keeping any servers you already have.
claude_desktop_config.json
1{
2 "mcpServers": {
3 "apifreaks": {
4 "command": "npx",
5 "args": ["-y", "@apifreaks/mcp"],
6 "env": {
7 "APIFREAKS_API_KEY": "your_apikey_here",
8 "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
9 }
10 }
11 }
12}
3
Restart Claude Desktop
Quit the app completely and open it again.

Choose your modules

ENABLE_MODULES controls which tools your client loads. If it's empty, only list_modules is listed. Every module ID is in the Modules section above.

Verify the connection

In a new chat, click +, open Connectors, and look for apifreaks.
Ask: "Who owns the domain apple.com?"

Cursor

AI editor

Before you start

Node.js 20 or higher (check with node -v)
An APIFreaks API key from your dashboard
A list of modules to enable, such as ip-intelligence,whois,dns

1
Create the config file
Use .cursor/mcp.json in your project, or ~/.cursor/mcp.json for every project.
.cursor/mcp.json
1{
2 "mcpServers": {
3 "apifreaks": {
4 "command": "npx",
5 "args": ["-y", "@apifreaks/mcp"],
6 "env": {
7 "APIFREAKS_API_KEY": "your_apikey_here",
8 "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
9 }
10 }
11 }
12}
2
Restart Cursor
Save the file, then quit Cursor and open it again. You can also add the server from Cursor Settings > MCP.

Choose your modules

ENABLE_MODULES controls which tools your client loads. If it's empty, only list_modules is listed. Every module ID is in the Modules section above.

Verify the connection

In Cursor Settings, apifreaks shows in the MCP list as enabled, with its tools listed.
Ask in Agent mode, so Cursor can call tools.

VS Code

Editor with Copilot

Before you start

Node.js 20 or higher (check with node -v)
An APIFreaks API key from your dashboard
A list of modules to enable, such as ip-intelligence,whois,dns

1
Add the server
Add this to ~/.copilot/mcp-config.json to use the server in every workspace.
~/.copilot/mcp-config.json
1{
2 "mcpServers": {
3 "apifreaks": {
4 "type": "stdio",
5 "command": "npx",
6 "args": ["-y", "@apifreaks/mcp"],
7 "env": {
8 "APIFREAKS_API_KEY": "your_apikey_here",
9 "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
10 },
11 "tools": ["*"]
12 }
13 }
14}
2
Check the server is running
Run Chat: Open Customizations from the Command Palette and open MCP Servers. Start apifreaks if it isn't running.

Choose your modules

ENABLE_MODULES controls which tools your client loads. If it's empty, only list_modules is listed. Every module ID is in the Modules section above.

Verify the connection

apifreaks is listed and running under MCP Servers.
To share it with your team, put the block in .mcp.json at the workspace root and use ${APIFREAKS_API_KEY} in place of your key.

Windsurf

AI editor

Before you start

Node.js 20 or higher (check with node -v)
An APIFreaks API key from your dashboard
A list of modules to enable, such as ip-intelligence,whois,dns

1
Edit the config file
Open ~/.codeium/windsurf/mcp_config.json and add the entry.
~/.codeium/windsurf/mcp_config.json
1{
2 "mcpServers": {
3 "apifreaks": {
4 "command": "npx",
5 "args": ["-y", "@apifreaks/mcp"],
6 "env": {
7 "APIFREAKS_API_KEY": "your_apikey_here",
8 "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
9 }
10 }
11 }
12}
2
Refresh the server list
In Cascade, open the MCP panel and press refresh.

Choose your modules

ENABLE_MODULES controls which tools your client loads. If it's empty, only list_modules is listed. Every module ID is in the Modules section above.

Verify the connection

apifreaks appears in the MCP panel with its tools.

Codex CLI

Terminal agent

Before you start

Node.js 20 or higher (check with node -v)
An APIFreaks API key from your dashboard
A list of modules to enable, such as ip-intelligence,whois,dns

1
Add the server
One command registers it.
terminal
1codex mcp add apifreaks --env APIFREAKS_API_KEY=your_apikey_here --env ENABLE_MODULES=ip-intelligence,currency,whois,dns,weather -- npx -y @apifreaks/mcp
2
Start a new session
Open a fresh Codex session after adding the server.

Choose your modules

ENABLE_MODULES controls which tools your client loads. If it's empty, only list_modules is listed. Every module ID is in the Modules section above.

Verify the connection

Run codex mcp list and confirm apifreaks is listed.

Gemini CLI

Terminal agent

Before you start

Node.js 20 or higher (check with node -v)
An APIFreaks API key from your dashboard
A list of modules to enable, such as ip-intelligence,whois,dns

1
Edit the settings file
Use ~/.gemini/settings.json, or .gemini/settings.json in a project.
~/.gemini/settings.json
1{
2 "mcpServers": {
3 "apifreaks": {
4 "command": "npx",
5 "args": ["-y", "@apifreaks/mcp"],
6 "env": {
7 "APIFREAKS_API_KEY": "your_apikey_here",
8 "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
9 }
10 }
11 }
12}
2
Restart Gemini CLI
Close it and open it again so it loads the server.

Choose your modules

ENABLE_MODULES controls which tools your client loads. If it's empty, only list_modules is listed. Every module ID is in the Modules section above.

Verify the connection

Run /mcp list and confirm apifreaks is connected.

Cline

VS Code extension

Before you start

Node.js 20 or higher (check with node -v)
An APIFreaks API key from your dashboard
A list of modules to enable, such as ip-intelligence,whois,dns

1
Open the settings file
In Cline, open the MCP Servers panel, click Configure, then Configure MCP Servers. Or edit the file 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
2
Add the server
cline_mcp_settings.json
1{
2 "mcpServers": {
3 "apifreaks": {
4 "command": "npx",
5 "args": ["-y", "@apifreaks/mcp"],
6 "env": {
7 "APIFREAKS_API_KEY": "your_apikey_here",
8 "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
9 }
10 }
11 }
12}
3
Restart Cline
Restart Cline after saving.

Choose your modules

ENABLE_MODULES controls which tools your client loads. If it's empty, only list_modules is listed. Every module ID is in the Modules section above.

Verify the connection

apifreaks is listed in the MCP Servers panel and turned on.

OpenCode

Terminal agent

Before you start

Node.js 20 or higher (check with node -v)
An APIFreaks API key from your dashboard
A list of modules to enable, such as ip-intelligence,whois,dns

1
Edit the config file
Open ~/.config/opencode/opencode.json and add the entry.
~/.config/opencode/opencode.json
1{
2 "$schema": "https://opencode.ai/config.json",
3 "mcp": {
4 "apifreaks": {
5 "type": "local",
6 "command": ["npx", "-y", "@apifreaks/mcp"],
7 "environment": {
8 "APIFREAKS_API_KEY": "your_apikey_here",
9 "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
10 }
11 }
12 }
13}
2
Restart OpenCode
Close OpenCode and open it again so it loads the server.

Choose your modules

ENABLE_MODULES controls which tools your client loads. If it's empty, only list_modules is listed. Every module ID is in the Modules section above.

Verify the connection

Run opencode mcp list and confirm apifreaks is connected.

One-click setup with Glama

The APIFreaks MCP server is listed on Glama. Click Connect on the listing and follow the prompts. Glama generates the right config for your client.

Try it

You don't call tools by name. Ask in plain language and the assistant picks the right one.

prompt

1Who owns stripe.com? Give me the registrar and the expiry date.

prompt

1Where is 8.8.8.8 located, and is it flagged as a VPN or proxy?

prompt

1What are the MX and NS records for github.com?

prompt

1What is the standard VAT rate in Germany?

More prompts for every tool: Remote server tools and Local server tools.

Client support

Which clients can use which method.

Client	Remote (HTTP)	Local (stdio)
Claude (web)		Not supported
Claude Desktop
Claude Code
Cursor
VS Code
Windsurf
Codex CLI
Gemini CLI
Cline
OpenCode

Claude on the web can't start programs on your computer, so it only works with the remote server.

Need an API key?

Create a free account and get 10,000 free requests. No credit card required.

Create free account Troubleshooting

Choose a connection method

Modules

Choose your client

Claude

Before you start

Add the connector

Sign in

Turn it on in a chat

Verify the connection

Claude Code

Before you start

Add the server

Sign in

Or share it with your team

Verify the connection

Cursor

Before you start

Create the config file

Restart Cursor and sign in

Or use your API key instead

Verify the connection

VS Code

Before you start

Add the server

Start the server and sign in

Or use your API key instead

Verify the connection

Windsurf

Before you start

Edit the config file

Refresh and sign in

Or use your API key instead

Verify the connection

Codex CLI

Before you start

Add the server

Sign in

Or use your API key instead

Verify the connection

Gemini CLI

Before you start

Add the server

Sign in

Or use your API key instead

Verify the connection

Cline

Before you start

Open the settings file

Add the server

Sign in

Or use your API key instead

Verify the connection

OpenCode

Before you start

Edit the config file

Sign in

Or use your API key instead

Verify the connection

Choose your client

Claude Code

Before you start

Add the server

Or edit the config file

Start a new session

Verify the connection

Claude Desktop

Before you start

Open the config file

Add the server

Restart Claude Desktop

Verify the connection

Cursor

Before you start

Create the config file

Restart Cursor

Verify the connection

VS Code

Before you start

Add the server

Check the server is running