`geolocate_ip`

Pack: iplookup · Endpoint: https://gateway.pipeworx.io/iplookup/mcp

Look up an IP address to find its location and network details. Returns country, region, city, coordinates, timezone, ISP, and AS number. Use when you need to identify where a user or server is located.

Parameters

Name	Type	Required	Description
`ip`	string	yes	IPv4 or IPv6 address to look up (e.g., “8.8.8.8”, “2001:4860:4860::8888”)

Example call

Arguments

{
  "ip": "8.8.8.8"
}

curl

curl -X POST https://gateway.pipeworx.io/iplookup/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"geolocate_ip","arguments":{"ip":"8.8.8.8"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('geolocate_ip', {
  "ip": "8.8.8.8"
});

More examples

{
  "ip": "2001:4860:4860::8888"
}

Response shape

Always returns: ip, country, country_code, region, city, postal_code, latitude, longitude, timezone, isp, organization, as_number

Field	Type	Description
`ip`	string \| null	The queried IP address
`country`	string \| null	Country name
`country_code`	string \| null	ISO 3166-1 alpha-2 country code
`region`	string \| null	State/region name
`city`	string \| null	City name
`postal_code`	string \| null	ZIP or postal code
`latitude`	number \| null	Latitude coordinate
`longitude`	number \| null	Longitude coordinate
`timezone`	string \| null	IANA timezone identifier
`isp`	string \| null	Internet Service Provider name
`organization`	string \| null	Organization name
`as_number`	string \| null	Autonomous System number and name

Full JSON Schema

{
  "type": "object",
  "properties": {
    "ip": {
      "type": [
        "string",
        "null"
      ],
      "description": "The queried IP address"
    },
    "country": {
      "type": [
        "string",
        "null"
      ],
      "description": "Country name"
    },
    "country_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO 3166-1 alpha-2 country code"
    },
    "region": {
      "type": [
        "string",
        "null"
      ],
      "description": "State/region name"
    },
    "city": {
      "type": [
        "string",
        "null"
      ],
      "description": "City name"
    },
    "postal_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "ZIP or postal code"
    },
    "latitude": {
      "type": [
        "number",
        "null"
      ],
      "description": "Latitude coordinate"
    },
    "longitude": {
      "type": [
        "number",
        "null"
      ],
      "description": "Longitude coordinate"
    },
    "timezone": {
      "type": [
        "string",
        "null"
      ],
      "description": "IANA timezone identifier"
    },
    "isp": {
      "type": [
        "string",
        "null"
      ],
      "description": "Internet Service Provider name"
    },
    "organization": {
      "type": [
        "string",
        "null"
      ],
      "description": "Organization name"
    },
    "as_number": {
      "type": [
        "string",
        "null"
      ],
      "description": "Autonomous System number and name"
    }
  },
  "required": [
    "ip",
    "country",
    "country_code",
    "region",
    "city",
    "postal_code",
    "latitude",
    "longitude",
    "timezone",
    "isp",
    "organization",
    "as_number"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "iplookup": {
      "url": "https://gateway.pipeworx.io/iplookup/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

geolocate_ip