How to Use the IPinfo MCP in Claude

Q: Can Claude Desktop use IPinfo to check my own public IP?

Yes, your agent can run the getownipdetails tool to verify the public IP address of your running host. This helps you confirm that your local proxy or VPN configuration is working before you run wider tests.

Run IPinfo lookups directly inside Claude Desktop to spot malicious traffic and map network infrastructure during live chats.

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 Claude Desktop

Create your Vinkius account to connect IPinfo to Claude Desktop 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 Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Audit incoming traffic directly in Claude Desktop

When you paste a suspicious IP into Claude Desktop, your agent immediately calls `get_ip_details` to pull the physical location and carrier. You don't have to open a browser tab or run a manual command. The tool output feeds straight into your Claude Desktop conversation via the MCP protocol, letting you analyze server logs or investigate security alerts on the fly. You get raw, accurate network telemetry right where you write your post-mortems.

Expose VPNs and proxies using this MCP Server

Here's the thing: spotting automated bots or bad actors inside Claude Desktop is dead simple when you run `get_privacy_details`. This tool tells your agent if the connection is hiding behind a Tor exit node, a commercial VPN, or a hosting provider. If a Claude Desktop user reports an issue, your agent checks the IP range via `get_ip_range` to see if they belong to a known cloud provider. You instantly know if you're dealing with a real customer or just a script scraping your endpoints.

Trace network operators and ASNs in your chat

Feed an autonomous system number to Claude Desktop and watch it run `get_asn_details` to map out the network owner. You don't need to dig through WHOIS records manually when your agent can pull the routing data for you. Combined with `get_ip_historical` in Claude Desktop, you can trace ownership changes over time to spot hijacked prefixes. Your agent handles the API calls and summarizes the network shifts so you can make fast firewall decisions.

Setup guide

Set up IPinfo MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The IPinfo MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the IPinfo MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under ipinfo-mcp.

json

{
  "mcpServers": {
    "ipinfo-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Claude Desktop

Open your local configuration file and add the IPinfo MCP server details under the mcpServers key. Once you restart Claude Desktop, the agent will have immediate access to all six network lookup tools.

Yes, your agent can run the `get_own_ip_details` tool to verify the public IP address of your running host. This helps you confirm that your local proxy or VPN configuration is working before you run wider tests.

You need a valid token from your account to authenticate the requests inside Claude Desktop. Paste the token into the environment variables of your config file so your agent can fetch live ASN and geolocation data.

The server passes standard API limit headers directly to your agent. If you hit your plan limits, Claude Desktop will receive a standard error response, prompting you to pace your queries or upgrade your plan.

Your queried IP addresses and ASN strings are sent directly to the API endpoints for resolution. Vinkius handles these requests in a secure, ephemeral sandbox, meaning your raw network metadata is never stored or used for training 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