How to Use the IPGeolocation.io MCP in Claude

Q: How do I configure the IPGeolocation.io MCP Server inside Claude Desktop?

Open your local claudedesktopconfig.json file and add the IPGeolocation.io MCP Server configuration block under the servers key. Once you restart the desktop app, the hammer icon will show your new geolocation tools.

Q: Can Claude Desktop run bulk security checks with IPGeolocation.io?

Yes, your agent invokes the bulksecurity tool to process lists of IPs you paste into the chat. It queries the API and returns threat scores for each address in a single pass.

Q: Which tool handles ASN lookups?

Your agent calls getasn to pull autonomous system numbers and ISP details. This helps you identify the network provider behind any specific IP address during chat analysis.

Feed Claude Desktop live IP intelligence and timezone data from IPGeolocation.io to block bad actors and coordinate global teams.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect IPGeolocation.io MCP to Claude Desktop

Create your Vinkius account to connect IPGeolocation.io 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 IPGeolocation.io with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Spot malicious traffic directly inside Claude Desktop

Feed Claude Desktop raw IP addresses and let your agent run `get_security` to flag proxies, VPNs, or tor exit nodes instantly. This keeps your local development environment safe because the agent screens incoming webhook IPs before you write a single line of firewall rules. When you need to inspect multiple targets at once, the `bulk_security` tool handles batch processing inside your chat window. You don't have to copy-paste IPs into a browser terminal anymore since the desktop app handles the payload parsing natively.

Convert global timezones in your chat window

Stop looking up time zones manually when scheduling system maintenance. By running `convert_timezone` and `get_timezone` through this MCP Server, your agent coordinates release windows across multiple engineering hubs without scheduling conflicts. The agent can also pull localized sun and moon positions using `get_astronomy` for regional operations. This data prints directly into your sidebar, keeping your team aligned on maintenance windows.

Parse complex user agents with this MCP Server

Debugging browser issues gets simpler when you pass raw header strings straight to Claude Desktop. The `get_user_agent` tool breaks down messy headers into clean device, OS, and browser versions during your debugging sessions. For larger access logs, the `bulk_user_agent` tool processes multiple records simultaneously. Your agent formats the output into a clean markdown table so you can spot browser-specific bugs immediately.

Setup guide

Set up IPGeolocation.io 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 IPGeolocation.io 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 IPGeolocation.io 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 ipgeolocationio-mcp.

json

{
  "mcpServers": {
    "ipgeolocationio-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 IPGeolocation.io. 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 IPGeolocation.io 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 IPGeolocation.io MCP in Claude Desktop

Open your local `claude_desktop_config.json` file and add the IPGeolocation.io MCP Server configuration block under the servers key. Once you restart the desktop app, the hammer icon will show your new geolocation tools.

Yes, your agent invokes the `bulk_security` tool to process lists of IPs you paste into the chat. It queries the API and returns threat scores for each address in a single pass.

No, Vinkius handles the underlying authentication for you. You only need to plug in your single Vinkius connection token to grant Claude Desktop access to all eleven geolocation tools.

Your agent calls `get_asn` to pull autonomous system numbers and ISP details. This helps you identify the network provider behind any specific IP address during chat analysis.

All IP addresses and user-agent strings sent through this connection run inside an ephemeral V8 sandbox. Vinkius never stores the payloads of your queries, ensuring your network logs remain confidential.

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