MCP IP Geolocation Server

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

typescript

3

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

This MCP server provides IP geolocation data by querying IP-API.com, returning detailed location information, network data, and timezone details for any IP address. It lets you integrate reliable geolocation into your applications or Claude workflows without requiring API keys, and it formats the output for easy consumption.

How to use

You run the MCP server locally or in your environment and then query it from your MCP client or Claude workflow. Start the server, then request information for the target IPs to obtain location, ISP, AS, and timezone details. The output is designed to be clean and easy to display within your tools.

How to install

Prerequisites: ensure you have a supported runtime for MCP servers, typically Node.js and npm, plus optional yarn for development builds.

# Install the global MCP server tool
npm install -g mcp-ip-geolocator

# Run the server directly
mcp-ip-geolocator

Additional setup and examples

If you prefer a local development flow with building and starting from source, you can clone the project, install dependencies, build, and start the server.

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

# Install dependencies
yarn install

# Build the project
yarn build

# Start the built server
yarn start

Available tools

IP geolocation lookup

Query an IP address to retrieve detailed geolocation information including city, region, country, latitude, longitude, timezone, ISP, organization, and AS number.

Output formatting

Receive structured, human-friendly output suitable for display in Claude or other MCP clients.

IP-API backend access

Leverages IP-API.com as the data source for geolocation data without requiring an API key.