`geolocate_ip`

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

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/geolocate_ip for the schema, then POST the same URL with its arguments for the data.

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