How to Use the IPinfo MCP in OpenAI Agents SDK

Q: How do I configure the IPinfo MCP Server with the OpenAI Agents SDK?

Install openai-agents and register the MCP Server pointing to your Vinkius endpoint. Pass the server instance inside the mcpservers list when creating your Agent, and the tools will auto-discover instantly.

Q: Can my OpenAI Agents SDK system block VPNs automatically using IPinfo?

Yes. Your agent can run getprivacydetails on any incoming IP and use the boolean flags for Tor or VPNs to trigger an immediate policy block.

Stop writing IP lookup wrappers; feed live geolocation and VPN telemetry directly to your OpenAI Agents SDK production pipelines.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect IPinfo MCP to OpenAI Agents SDK

Create your Vinkius account to connect IPinfo 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 IPinfo with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Spot VPNs and proxies in OpenAI Agents SDK

The `get_privacy_details` tool identifies masked traffic instantly. When your OpenAI Agents SDK system processes a user action, the agent queries this tool to check if the incoming request originates from a Tor exit node, a public proxy, or a commercial VPN. Routing high-risk traffic to specialized security agents is straightforward using native OpenAI handoffs. If the tool flags a connection, the agent immediately transfers the session to a restricted state, keeping your core production system safe from automated bot attacks.

Map network infrastructure using ASNs

The `get_asn_details` tool exposes the Autonomous System Number and ownership details of any IP address. Your OpenAI Agents SDK workflow uses this data to identify hosting providers or consumer ISPs on the fly. These guardrails ensure your agent doesn't execute risky actions based on outdated MCP data. This prevents your agent from accidentally triggering actions on IPs owned by known malicious cloud ranges or suspicious hosting environments.

Analyze historical IP assignments

The `get_ip_historical` tool retrieves historical ownership records for specific IP addresses. Your OpenAI Agents SDK agent uses this lookup to check if an IP has recently changed hands or if its legacy behavior matches current threat intelligence. To keep performance high, you should set `cacheToolsList=True` in your HTTP server streamable configuration. This stops the agent from making redundant schema discovery calls every time it evaluates historical network changes.

Setup guide

Set up IPinfo 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 IPinfo tools at runtime.
3

Create your Agent

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

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate IPinfo 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="IPinfo Agent",
            instructions="You have access to IPinfo 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 IPinfo. 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 IPinfo 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 IPinfo MCP in OpenAI Agents SDK

Install `openai-agents` and register the MCP Server pointing to your Vinkius endpoint. Pass the server instance inside the `mcp_servers` list when creating your Agent, and the tools will auto-discover instantly.

Yes. Your agent can run `get_privacy_details` on any incoming IP and use the boolean flags for Tor or VPNs to trigger an immediate policy block.

The SDK relies on standard HTTP error propagation. You can configure retry policies on your OpenAI agent or implement a caching layer on your Vinkius endpoint to manage your IPinfo API quota.

Yes, you can filter the tool list during server initialization or use specialized system instructions to prevent the agent from calling tools like `get_ip_range` when it only needs basic geolocation.

All IP lookup payloads are processed in memory inside a zero-trust V8 Isolate sandbox. Vinkius never logs the queried IP addresses or network metadata, and your data is never used to train OpenAI models.

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

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript