How to Use the IP2WHOIS MCP in OpenAI Agents SDK

Q: Does IP2WHOIS in OpenAI Agents SDK expose private contact data?

It provides access to public WHOIS records, including getdomaincontacts. Keep in mind that many modern domains use privacy proxies, so contact fields are often redacted.

Use the IP2WHOIS MCP Server to automate domain investigations directly inside your OpenAI Agents SDK production pipeline.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect IP2WHOIS MCP to OpenAI Agents SDK

Create your Vinkius account to connect IP2WHOIS to OpenAI Agents SDK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup IP2WHOIS with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Batch domain analysis for your agent

Your agent can trigger `bulk_whois_lookup` to pull registration data for hundreds of domains in a single pass. This avoids the latency of sequential calls and keeps your threat intelligence pipeline moving fast. Since you are using the OpenAI Agents SDK, the tool output flows into your agent's context immediately. It handles the structured JSON from the server and lets your agent make decisions based on registration dates or registrar names without manual parsing.

Verify domain status and expiration

Use `check_domain_expiry` and `check_domain_age` to filter out suspicious infrastructure before your agent takes further action. These tools provide raw data points that serve as reliable triggers for your internal safety guardrails. If a domain was registered yesterday and has no clear ownership, your agent can flag it as a risk. Feeding these metrics into your logic ensures that your automated system operates on verified data rather than assumptions.

Trace infrastructure with hosted domains

Run `lookup_hosted_domains` to find every site sharing an IP address with a target. This helps your agent identify clusters of malicious activity during an incident response workflow. Your agent will map these connections and update its internal trace logs. By integrating this MCP Server, you get a clear view of the host's footprint without leaving your agent's execution environment.

Setup guide

Set up IP2WHOIS MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all IP2WHOIS tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives IP2WHOIS tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate IP2WHOIS tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="IP2WHOIS Agent",
            instructions="You have access to IP2WHOIS tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by IP2WHOIS. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect IP2WHOIS now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about IP2WHOIS MCP in OpenAI Agents SDK

You connect the server by passing it to your agent constructor. The SDK auto-discovers the tools, letting you call them as standard Python functions within your agent's logic.

Yes. You can script your agent to query domains, check their age, and parse registrar info automatically. It turns your agent into an investigator that works 24/7.

It provides access to public WHOIS records, including `get_domain_contacts`. Keep in mind that many modern domains use privacy proxies, so contact fields are often redacted.

The server uses standard authentication handled by your endpoint token. Your agent interacts with the tools through a secure, ephemeral session.

The server provides structured JSON responses. You can use the agent's built-in validation to check the payload before proceeding with any action.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python