MCP IP Geolocation Server

by tedlikeskix

380 downloads
Not rated
GitHub

About

MCP server providing IP geolocation via IP-API.com. Free, no API key required.

Details

Author
tedlikeskix
Downloads
380
Categories
Other

- Get detailed location information for any IP address
- Network information including ISP and AS number
- Timezone data
- No API key or registration required
- Clean, formatted output for Claude

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP IP Geolocation Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install globally with npm install -g mcp-ip-geolocator and run mcp-ip-geolocator. Connect the server to Claude Desktop, then ask Claude to check the location of an IP address (e.g., “Claude, can you check the location of IP address 8.8.8.8?”).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp ip geolocation server": {
            "mcp-ip-geolocator": {
                "command": "npx",
                "args": [
                    "mcp-ip-geolocator"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-ip-geolocator": {
        "command": "npx",
        "args": [
            "mcp-ip-geolocator"
        ]
    }
}

MCP IP Geolocation Server

A Model Context Protocol (MCP) server that provides IP geolocation services via IP-API.com. Free to use, no API key required.

Features

- Get detailed location information for any IP address
- Network information including ISP and AS number
- Timezone data
- No API key or registration required
- Clean, formatted output for Claude

Quick Start

1. Install globally:

npm install -g mcp-ip-geolocator

2. Run the server:

mcp-ip-geolocator

Local Development

1. Clone the repository:

git clone https://github.com/tedlikeskix/mcp-ip-geolocator.git
cd mcp-ip-geolocator

2. Install dependencies:

yarn install

3. Build and run:

yarn build
yarn start

Usage with Claude

Once running, connect to the server in Claude Desktop. Example usage:

Claude, can you check the location of IP address 8.8.8.8?

Claude will use the tool to fetch and display location information.

API Response Format

The tool returns structured data including:
- City, region, and country
- Latitude and longitude
- Timezone
- ISP and organization
- AS number

Rate Limiting

IP-API.com's free tier includes:
- 45 requests per minute
- IPv4 and IPv6 support
- No API key needed

License

MIT License - feel free to use and modify!

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.