IP Geolocation

v1.0.19Search & Data Extractionstable

An MCP (Multi-Agent Conversation Protocol) server that enables natural language interaction with the AbstractAPI geolocation service, allowing users to retrieve geographic information about IP addresses.

ip-geolocation-mcp-servermcpai-integration
Share:
43
Stars
0
Downloads
0
Weekly
0/5

What is IP Geolocation?

IP Geolocation is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp (multi-agent conversation protocol) server that enables natural language interaction with the abstractapi geolocation service, allowing users to retrieve geographic information about ip addresses....

An MCP (Multi-Agent Conversation Protocol) server that enables natural language interaction with the AbstractAPI geolocation service, allowing users to retrieve geographic information about IP addresses.

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • An MCP (Multi-Agent Conversation Protocol) server that enabl

Use Cases

Get geographic information from IP addresses
Determine user location data
briandconnelly

Maintainer

LicenseMIT License
Languagepython
Versionv1.0.19
UpdatedMay 10, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y ipgeolocation-io-mcp

Manual Installation

npx -y ipgeolocation-io-mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use IP Geolocation

The ipgeolocation-io-mcp server connects AI assistants to the AbstractAPI (and ipgeolocation.io) geolocation service, enabling natural language queries that retrieve detailed geographic information about any IP address, including country, city, timezone, currency, and connection type. It is distributed as an npm package and requires an API key from ipgeolocation.io to function. Network administrators, fraud analysts, and developers who need to enrich IP address data within AI conversations can use this server to get structured geolocation responses without writing API calls manually.

Prerequisites

  • Node.js 16 or higher installed
  • An ipgeolocation.io account with an API key (free tier available at ipgeolocation.io)
  • An MCP-compatible client such as Claude Desktop or Claude Code
1

Sign up for an ipgeolocation.io API key

Visit https://ipgeolocation.io and create a free account. After signing up, copy your API key from the dashboard. The free tier allows up to 1,000 requests per day.

2

Test the package with npx

Verify the package is accessible via npx. The server will start in STDIO mode and exit immediately without an MCP client — this is expected.

npx -y ipgeolocation-io-mcp
3

Add the server to your MCP client configuration

Add the server entry to claude_desktop_config.json with your ipgeolocation.io API key in the env block.

{
  "mcpServers": {
    "ip-geolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "your_api_key_here"
      }
    }
  }
}
4

Restart your MCP client

Restart Claude Desktop or reload MCP servers in your client to discover the ip-geolocation server and its tools.

IP Geolocation Examples

Client configuration

Complete claude_desktop_config.json entry for the IP Geolocation MCP Server using ipgeolocation.io.

{
  "mcpServers": {
    "ip-geolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp"],
      "env": {
        "IPGEOLOCATION_API_KEY": "your_ipgeolocation_io_api_key_here"
      }
    }
  }
}

Prompts to try

Example prompts for querying IP geolocation data through the MCP server.

- "Where is the IP address 185.220.101.34 located?"
- "What country and timezone is 8.8.4.4 in?"
- "Look up the currency and language for the region where 203.0.113.45 is registered"
- "Is 192.168.1.1 a valid public IP, and if so where is it geographically?"
- "Get detailed connection info for IP 1.1.1.1 including ISP and organization name"

Troubleshooting IP Geolocation

Server returns '401 Unauthorized' for every IP lookup

Verify that the IPGEOLOCATION_API_KEY environment variable is correctly set in your MCP config and that the key matches the one shown in your ipgeolocation.io dashboard. Check that there are no extra spaces or newline characters around the key value.

npx fails with ENOTFOUND or package not found

Clear the npx cache with 'npx clear-npx-cache' and retry. Verify your internet connection and that the package name 'ipgeolocation-io-mcp' is spelled correctly in the args array.

Daily request limit exceeded

The free tier of ipgeolocation.io allows 1,000 requests per day. Upgrade to a paid plan at ipgeolocation.io/pricing for higher limits, or reduce usage by caching results at the application level.

Frequently Asked Questions about IP Geolocation

What is IP Geolocation?

IP Geolocation is a Model Context Protocol (MCP) server that mcp (multi-agent conversation protocol) server that enables natural language interaction with the abstractapi geolocation service, allowing users to retrieve geographic information about ip addresses. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install IP Geolocation?

Install via npm with the command: npx -y ipgeolocation-io-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with IP Geolocation?

IP Geolocation works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is IP Geolocation free to use?

Yes, IP Geolocation is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use IP Geolocation?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides