mcpField
M
MCP IP Geolocation Server

MCP IP Geolocation Server

Local
github.com/tedlikeskixMaps & Travel2Updated 91w ago
Repository

About MCP IP Geolocation Server

An MCP server that retrieves IP geolocation and network details through IP-API.com. It is for MCP clients that need location, timezone, and ISP information for IPv4 or IPv6 addresses without an API key.

Key features

  1. 01IP address location lookup
  2. 02ISP and AS number details
  3. 03Timezone information
  4. 04IPv4 and IPv6 support

Use cases

  1. 01Check the location of an IP address
  2. 02Identify an IP's ISP and network
  3. 03Retrieve timezone details for an IP

MCP support

Exposes an IP geolocation tool to MCP clients, returning location, network, and timezone data.

#mcp-ip-geolocator#ip-geolocation#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "ip-geolocator": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-ip-geolocator"
      ]
    }
  }
}
Run commandnpx -y mcp-ip-geolocator

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmmcp-ip-geolocator

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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
  1. 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
  1. Install dependencies:
yarn install
  1. 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!

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.