MCP Server — IP Geolocation for AI Assistants

Integrate IP geolocation directly into your AI assistants (Claude Desktop, Claude Code, Cursor...) via the MCP protocol. Free, open source, pure PHP.

What is MCP?

Model Context Protocol (MCP) is an open standard created by Anthropic that allows AI assistants to interact with external tools. An MCP server exposes "tools" that the AI can call to fetch real-time data.

The MonIP MCP server lets your AI assistant look up information for any IP address: country, city, GPS coordinates, ISP, ASN, hostname — just like the website, but accessible directly from your conversation.

Available tools

ip_lookup

Full IP address lookup: country, city, region, GPS coordinates, timezone, ISP, ASN, hostname (reverse DNS). Supports both IPv4 and IPv6.

ip_geolocate

Concise IP geolocation: returns country, city and coordinates in one line. Ideal for a quick overview.

ip_validate

Checks whether a string is a valid IP address. Returns the version (IPv4/IPv6) and whether it is public or private.

Quick connect (remote server)

No installation required. Simply add the MonIP MCP server URL to your client:

MCP server URL : https://monip.lws.fr/mcp/sse

Claude.ai (custom connector)

In Claude.ai, go to Settings > Connectors > Add custom connector, then enter:

# Name
MonIP

# Remote MCP server URL
https://monip.lws.fr/mcp/sse

Claude Desktop

{
  "mcpServers": {
    "monip": {
      "type": "url",
      "url": "https://monip.lws.fr/mcp/sse"
    }
  }
}

Claude Code

# .claude/settings.json
{
  "mcpServers": {
    "monip": {
      "type": "url",
      "url": "https://monip.lws.fr/mcp/sse"
    }
  }
}

Cursor

# .cursor/mcp.json
{
  "mcpServers": {
    "monip": {
      "url": "https://monip.lws.fr/mcp/sse"
    }
  }
}

Usage examples

"Locate IP 8.8.8.8"

The assistant calls ip_lookup and returns the country, city, ISP, ASN, etc.
"Is 192.168.1.1 a valid IP address?"

The assistant calls ip_validate and responds that it's a private IPv4.
"Where is server 1.1.1.1 located?"

The assistant calls ip_geolocate and gives Cloudflare's location.

Quick test

Test the server with cURL:

curl -X POST https://monip.lws.fr/mcp/sse \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ip_lookup","arguments":{"ip":"8.8.8.8"}}}'

Back to MonIP