Network Attribute Resolution Engine (MCP)

This Model Context Protocol (MCP) service facilitates the lookup of extensive location metadata for supplied IP addresses, leveraging the free tier of IP-API.com.

Core Capabilities

• Derive granular positional data for any IPv4 or IPv6 notation.
• Extract network infrastructure details, such as the Internet Service Provider (ISP) and Autonomous System (AS) identifier.
• Determine the relevant time zone information.
• Operationally accessible without requiring an API authentication token or prior user registration.
• Generates structured, readily parsable output optimized for AI consumption (e.g., Claude).

Deployment Instructions

To install the command-line interface globally:

bash npm install -g mcp-ip-geolocator

To initiate the local service instance:

bash mcp-ip-geolocator

Development Setup

For source code modification or local testing:

1. Clone the project repository: bash git clone https://github.com/tedlikeskix/mcp-ip-geolocator.git cd mcp-ip-geolocator

2. Install requisite project dependencies: bash yarn install

3. Compile assets and execute the local server: bash yarn build yarn start

Integration within Conversational AI

Once the server is active, instruct your AI agent (like Claude Desktop) to utilize this function. For example:

AI, please ascertain the geographical context for the address 192.0.2.1 using the available network diagnostics tool.

The system will execute the lookup and present the resultant structured data.

Output Structure

The tool consistently returns a standardized data object containing:

• Geographic coordinates (latitude and longitude)
• Regional classifications (city, administrative region, sovereign state)
• Time zone assignment
• Designated Internet Service Provider and associated organization name
• Autonomous System number

Usage Quota Details

The underlying IP-API.com service permits:

• A maximum of 45 queries per minute.
• Compatibility across both IPv4 and IPv6 address families.
• Zero requirement for secret keys.

Legal Framework

Distributed under the terms of the MIT License. Usage and modification are freely permitted.