`lookup_ip`

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

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

Get geolocation and network info for any IP address (e.g., “8.8.8.8”). Returns city, region, country, coordinates, org, postal code, timezone.

Parameters

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

Example call

Arguments

{
  "ip": "8.8.8.8"
}

curl

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

TypeScript (@pipeworx/sdk)

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

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

More examples

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

Response shape

Always returns: ip, city, region, country, latitude, longitude, org, postal, timezone

Field	Type	Description
`ip`	string	The IP address that was looked up
`city`	string \| null	City name associated with the IP address
`region`	string \| null	Region or state associated with the IP address
`country`	string \| null	Country code associated with the IP address
`latitude`	number \| null	Latitude coordinate of the IP geolocation
`longitude`	number \| null	Longitude coordinate of the IP geolocation
`org`	string \| null	Organization or ISP name
`postal`	string \| null	Postal code associated with the IP address
`timezone`	string \| null	Timezone associated with the IP address

Full JSON Schema

{
  "type": "object",
  "properties": {
    "ip": {
      "type": "string",
      "description": "The IP address that was looked up"
    },
    "city": {
      "type": [
        "string",
        "null"
      ],
      "description": "City name associated with the IP address"
    },
    "region": {
      "type": [
        "string",
        "null"
      ],
      "description": "Region or state associated with the IP address"
    },
    "country": {
      "type": [
        "string",
        "null"
      ],
      "description": "Country code associated with the IP address"
    },
    "latitude": {
      "type": [
        "number",
        "null"
      ],
      "description": "Latitude coordinate of the IP geolocation"
    },
    "longitude": {
      "type": [
        "number",
        "null"
      ],
      "description": "Longitude coordinate of the IP geolocation"
    },
    "org": {
      "type": [
        "string",
        "null"
      ],
      "description": "Organization or ISP name"
    },
    "postal": {
      "type": [
        "string",
        "null"
      ],
      "description": "Postal code associated with the IP address"
    },
    "timezone": {
      "type": [
        "string",
        "null"
      ],
      "description": "Timezone associated with the IP address"
    }
  },
  "required": [
    "ip",
    "city",
    "region",
    "country",
    "latitude",
    "longitude",
    "org",
    "postal",
    "timezone"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

lookup_ip