How to integrate Whoisfreaks MCP with Codex

Connect Codex to Whoisfreaks MCP. Get whois info for google.com, check domain registration status for mysite.io, and more using natural language, with authentication handled for you.

Whoisfreaks logoWhoisfreaks
Api Key

Whoisfreaks is a leading provider of domain WHOIS database and API services. Instantly access comprehensive domain ownership and registration data for research and monitoring.

17 Tools

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With the Whoisfreaks MCP integration, Codex can run WHOIS and DNS lookups, check domain availability, find subdomains, inspect SSL certificates, and geolocate IP addresses, all without leaving the terminal or the app, whichever you prefer.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Whoisfreaks with

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

  • CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Large tool responses: Handle them to minimise context rot.
  • Dynamic just-in-time access to 20,000 tools across 1700+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need.

How to install Whoisfreaks MCP in Codex

Run the setup command

Run this command in your terminal to add the Composio MCP server to Codex.

Terminal

It will initiate the authentication in a browser window, authorize Codex to access your Composio account.

Composio authentication page

(Optional) Authenticate with OAuth

To authenticate manually, run the login command to open a browser window and authorize Codex to access your Composio account.

bash
codex mcp login composio

Verify the connection

Run codex mcp list to confirm Composio appears as a registered MCP server.

bash
codex mcp list

Codex App

Codex App follows the same approach as VS Code.

  1. Click ⚙️ on the bottom left → MCP Servers → + Add servers → Streamable HTTP:
  2. Fill the header and Key fields with { "x-consumer-api-key" = "ck_*******" }.
  3. The Key is the Composio API key, that you can find on dashboard.composio.dev
  4. Click on Authenticate and authorize Codex to your Composio account and you're all set.
Codex App MCP setup
  1. Restart and verify if it's there in .codex/config.toml
bash
[mcp_servers.composio]
url = "https://connect.composio.dev/mcp"
http_headers = { "x-consumer-api-key" = "ck_*******" }

Try it

Ask Codex for a Whoisfreaks task. The first time, Composio asks you to connect your Whoisfreaks account.

For example, ask it to:

  • "Get WHOIS info for google.com"
  • "Check domain registration status for mysite.io"
  • "List recent ownership changes for example.org"

What is the Whoisfreaks MCP server, and what's possible with it?

The Whoisfreaks MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Whoisfreaks account. It provides structured and secure access to domain, DNS, IP, ASN, SSL certificate, and security data, so your agent can research domain ownership, check domain availability, inspect network records, discover subdomains, and investigate security threats on your behalf.

  • Domain ownership research: Have your agent retrieve current or historical WHOIS records and find domains linked to a company, owner, or email address.
  • Domain and subdomain discovery: Let the agent check whether a domain is available, request alternatives, and discover subdomains associated with an existing domain.
  • DNS and certificate checks: Direct your agent to resolve live DNS records or inspect an SSL certificate's chain, issuer, and validity dates.
  • IP and network investigation: Instruct your agent to look up IP ownership, ISP and network details, geographic location, or ASN infrastructure and address ranges.
  • Security threat screening: Have your agent check whether an IP address is linked to malicious activity, known threats, or blocklists.

Conclusion

You've successfully integrated Whoisfreaks with Codex using Composio's MCP server. Now you can interact with Whoisfreaks directly from your terminal, VS Code, or the Codex App using natural language commands.

Key benefits of this setup:

  • Seamless integration across CLI, VS Code, and standalone app
  • Natural language commands for Whoisfreaks operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1700+ apps for cross-app workflows
  • CodeAct workbench for complex tool chaining

Next steps:

  • Try asking Codex to perform various Whoisfreaks operations
  • Explore cross-app workflows by connecting more toolkits
  • Build automation scripts that leverage Codex's AI capabilities
TOOLS

Supported Tools

Every Whoisfreaks action and event your agent gets out of the box.

ASN WHOIS Lookup

Tool to retrieve comprehensive ASN WHOIS information including ownership, network infrastructure, and IP address ranges.

Bulk DNS Lookup

Look up DNS records for batches of domains or IP addresses in a single request, specifying the record type.

Bulk Domain Availability Check

Tool to check availability of multiple domains in one request (max 100 domains).

Bulk WHOIS Lookup

Tool to query WHOIS information for up to 100 domains in a single request.

DNS Live Lookup

Tool to perform real-time DNS record resolution for network diagnostics and configuration verification.

Check Domain Availability

Tool to check if a domain is available for registration with optional suggestions.

Get Domain Files Status

Tool to check availability and update status of domain data files including newly registered, expired, and dropped domains.

IP Geolocation Lookup

Retrieve geographic location and network information for an IP address, including country, city, coordinates, and organization details where available.

IP WHOIS Lookup

Tool to retrieve comprehensive WHOIS information for an IP address including organization, ISP, and network details.

Security Threat Lookup

Tool to check if an IP address is associated with malicious activity, security threats, or appears on blocklists.

SSL Certificate Lookup

Tool to fetch live SSL certificate with full secure cert chain, validity dates, and issuer information.

Subdomain Lookup

Look up subdomains associated with a domain for security assessment, asset discovery, or reconnaissance.

WHOIS Historical Lookup

Tool to access historical domain records from comprehensive database with up to 100 records per page.

WHOIS Live Lookup V2

Tool to fetch real-time WHOIS domain data using v2.0 endpoint.

WHOIS Reverse Lookup By Company

Search reverse WHOIS records for domains associated with a company or organization.

WHOIS Reverse Lookup by Email

Tool to search for domains registered with a specific email address.

WHOIS Reverse Lookup By Owner

Search for domains associated with a registrant or owner name using reverse WHOIS, with pagination and an optional exact-match setting.

FAQ

Frequently asked questions

Start with Whoisfreaks.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Whoisfreaks tool your agent needs.Free to start.

Start building