mcp ip geolocator

Local 2025-09-01 00:15:49 0

Provides IP geolocation services using IP-API.com without requiring an API key, enabling users to obtain detailed location and network information for any IP address in a clean, formatted output.


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!