# IPGeolocation.io MCP Server

> IPGeolocation.io MCP Server is a freemium MCP server for developer tools. IP geolocation, ASN, VPN and proxy detection and time-zone lookups for AI clients. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://ipgeolocation.io/integrations/ipgeolocation-io-mcp
- **Repository:** https://github.com/ipgeolocation/ipgeolocation-io-mcp
- **MCP Registry name:** io.github.IPGeolocation/ipgeolocation-io-mcp
- **Categories:** developer tools, security
- **Listing updated:** 2026-11-14

## About

The official IPGeolocation.io server offers 17 tools covering location, company and ASN data, security checks, abuse contacts, time zones, astronomy, currency and user-agent parsing. Security results cover VPN, proxy, Tor, bot, hosting and spam detection.

It runs locally over stdio through npx and needs Node.js 22 or later; the client has to be able to launch a local command. An IPGeolocation.io API key is needed for 15 of the API tools, and a free key is available. get_my_ip needs no key, and get_cached_result reads lookups already held in memory, with the same key as the original request.

The docs include setup for Codex CLI and Claude Desktop, where it can be installed as an extension or as a .mcpb bundle. Version 2.0.3 was released on 2026-11-05. The README points to a pricing section based on API credits.

## Features

- **IP geolocation:** Location data for an address, such as where 8.8.8.8 is.
- **Security checks:** VPN, proxy, Tor, bot, hosting and spam signals.
- **ASN and company data:** Network and organisation details for an IP.
- **Abuse contacts:** Find who handles abuse reports for an address.
- **Time zone and astronomy:** Time-zone and sun and moon data.
- **User-agent parsing:** Break a user-agent string into parts.
- **Result cache:** get_cached_result pages through earlier results.

## Good for

- Check whether a visitor IP is a VPN or proxy
- Look up who owns an address in a log
- Find an abuse contact for a report
- Convert an IP into a local time zone

## Install

### Claude Code (Terminal)

```sh
claude mcp add ipgeolocation-io-mcp --env IPGEOLOCATION_API_KEY='<IPGEOLOCATION_API_KEY>' -- npx -y ipgeolocation-io-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ipgeolocation-io-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ipgeolocation-io-mcp"
      ],
      "env": {
        "IPGEOLOCATION_API_KEY": "<IPGEOLOCATION_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ipgeolocation-io-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ipgeolocation-io-mcp"
      ],
      "env": {
        "IPGEOLOCATION_API_KEY": "<IPGEOLOCATION_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ipgeolocation-io-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ipgeolocation-io-mcp"
      ],
      "env": {
        "IPGEOLOCATION_API_KEY": "<IPGEOLOCATION_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ipgeolocation-io-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ipgeolocation-io-mcp"
      ],
      "env": {
        "IPGEOLOCATION_API_KEY": "<IPGEOLOCATION_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "ipgeolocation-io-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ipgeolocation-io-mcp"
      ],
      "env": {
        "IPGEOLOCATION_API_KEY": "<IPGEOLOCATION_API_KEY>"
      }
    }
  }
}
```

## Tools

- `get_my_ip`: Return your own IP; no key needed
- `get_cached_result`: Read results already held in memory

## FAQ

### Do I need an API key?

Yes for 15 of the API tools; get_my_ip needs none. A free key can be created.

### What does it run on?

Node.js 22 or later, started over stdio with npx.

### Can it be installed in Claude Desktop?

Yes, as an extension from the directory or a .mcpb bundle from GitHub Releases.

### How many tools?

17.

### Is IPGeolocation.io MCP Server free?

IPGeolocation.io MCP Server has a free plan, with paid plans for more usage or features.

### How do I add IPGeolocation.io MCP Server to Claude Code?

Run this command in your terminal: claude mcp add ipgeolocation-io-mcp --env IPGEOLOCATION_API_KEY='<IPGEOLOCATION_API_KEY>' -- npx -y ipgeolocation-io-mcp

### What are the best alternatives to IPGeolocation.io MCP Server?

The closest alternatives to IPGeolocation.io MCP Server are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/ipgeolocation-io-mcp-server
