IPGeolocation.io MCP Server

Prompt

Locate 91.128.103.196 and give me the country, city, ASN, and local time.

Typical assistant answer

91.128.103.196 resolves to Stockholm, Sweden. The ASN is AS1257, operated by Tele2 Sverige AB. The local timezone is Europe/Stockholm, and the local time in this sample is 2026-02-12 18:36:54.401+0100.

Example tool output

{
  "ip": "91.128.103.196",
  "location": {
    "country_name": "Sweden",
    "state_prov": "Stockholms lan",
    "city": "Stockholm"
  },
  "asn": {
    "as_number": "AS1257",
    "organization": "Tele2 Sverige AB",
    "country": "SE"
  },
  "time_zone": {
    "name": "Europe/Stockholm",
    "current_time": "2026-02-12 18:36:54.401+0100"
  }
}

Prompt

Convert 2025-01-21 13:42:52 from DXB to LHR.

Typical assistant answer

2025-01-21 13:42:52 in Dubai converts to 2025-01-21 09:42:52 in London in this sample. The difference is 4 hours.

Example tool output

{
  "original_time": "2025-01-21 13:42:52",
  "converted_time": "2025-01-21 09:42:52",
  "diff_hour": 4,
  "diff_min": 240
}

Prompt

Who uses 1.1.1.1 and which ASN routes it?

Typical assistant answer

1.1.1.1 is used by APNIC Research and Development, while the ASN routing it is AS13335, operated by Cloudflare, Inc.

Example tool output

{
  "company": {
    "name": "APNIC Research and Development",
    "domain": "apnic.net"
  },
  "asn": {
    "as_number": "AS13335",
    "organization": "Cloudflare, Inc.",
    "country": "US"
  }
}

Prompt

Show sunrise and sunset for New York from 2025-06-16 to 2025-06-18.

Typical assistant answer

For this New York date range, sunrise is about 05:23 and sunset about 20:30 each day. Day length is about 15 hours, and the moon phase changes from waning gibbous to last quarter in this sample.

Example tool output

{
  "location": {
    "country_name": "United States",
    "state_prov": "New York",
    "city": "New York",
    "latitude": "40.76473",
    "longitude": "-74.00084"
  },
  "astronomy": [
    {
      "date": "2025-06-16",
      "sunrise": "05:23",
      "sunset": "20:30",
      "day_length": "15:06",
      "moon_phase": "WANING_GIBBOUS"
    },
    {
      "date": "2025-06-17",
      "sunrise": "05:23",
      "sunset": "20:30",
      "day_length": "15:06",
      "moon_phase": "LAST_QUARTER"
    }
  ]
}

Prompt

Parse this user agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_2) AppleWebKit/601.3.9 (KHTML, like Gecko) Version/9.0.2 Safari/601.3.9

Typical assistant answer

This user agent is Safari 9.0.2 on Mac OS 10.11.2, running on an Apple Macintosh desktop with an Intel CPU.

Example tool output

{
  "user_agent_string": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_2) AppleWebKit/601.3.9 (KHTML, like Gecko) Version/9.0.2 Safari/601.3.9",
  "name": "Safari",
  "type": "Browser",
  "version": "9.0.2",
  "device": {
    "name": "Apple Macintosh",
    "type": "Desktop",
    "brand": "Apple",
    "cpu": "Intel"
  },
  "operating_system": {
    "name": "Mac OS",
    "type": "Desktop",
    "version": "10.11.2"
  }
}

Prompt

Give me the abuse contact for 1.0.0.0.

Typical assistant answer

For 1.0.0.0, the abuse contact in this sample is IRT-APNICRANDNET-AU in Australia, covering route 1.0.0.0/24, with email helpdesk@apnic.net.

Example tool output

{
  "ip": "1.0.0.0",
  "abuse": {
    "route": "1.0.0.0/24",
    "country": "AU",
    "name": "IRT-APNICRANDNET-AU",
    "address": "PO Box 3646, South Brisbane, QLD 4101, Australia",
    "emails": ["helpdesk@apnic.net"]
  }
}

Single IP or domain lookup.

Plan: free and paidCredits: 1 base credit

Choose this when:

Free plan returns base location, country metadata, currency, timezone, and basic ASN.

Paid plans add network , company , and extended ASN fields. Paid plans also support include modules.

Parameter	Required	Description
ip		IPv4, IPv6, or domain. Domain lookup requires a paid plan
lang		Response language. Non-English values require a paid plan
include		Extra modules: security , abuse , hostname , liveHostname , hostnameFallbackLive , user_agent , geo_accuracy , dma_code , or *
fields		Comma-separated fields to return
excludes		Comma-separated fields to exclude
force_refresh		Bypass the MCP cache and force a fresh upstream request

Bulk IP lookup for multiple addresses or domains.

Plan: paid onlyCredits: 1 per IP

Choose this when:

Parameter	Required	Description
ips		Array of IP addresses or domains
lang		Response language
include		Extra modules per IP
fields		Comma-separated fields to return per IP
excludes		Comma-separated fields to exclude per IP
force_refresh		Bypass the MCP cache and force a fresh upstream request

The default cap is 1,000 items per MCP request. You can change it with IPGEOLOCATION_MCP_MAX_BULK_ITEMS .

Return the public IP address of the machine running this MCP server.

Plan: free and paidCredits: 0

Choose this when:

Parameters: none

This tool always goes upstream and is not cached.

Threat and anonymity lookup for a single IP.

Plan: paid onlyCredits: 2

Choose this when:

If the same prompt also needs ownership, city, timezone, network, or abuse details, prefer lookup_ip with targeted include , fields , and excludes .

Parameter	Required	Description
ip		IP address to check
fields		Comma-separated fields to return
excludes		Comma-separated fields to exclude
force_refresh		Bypass the MCP cache and force a fresh upstream request

Returns threat score, VPN/proxy/Tor flags, provider names, confidence scores, bot/spam indicators, anonymity flags, and cloud-provider status.

Threat and anonymity lookup for multiple IPs.

Plan: paid onlyCredits: 2 per IP

Choose this when:

Parameter	Required	Description
ips		Array of IP addresses
fields		Comma-separated fields to return per IP
excludes		Comma-separated fields to exclude per IP
force_refresh		Bypass the MCP cache and force a fresh upstream request

Current time and timezone details for a location.

Plan: free and paidCredits: 1

Choose this when:

Returns an object with location and time_zone . The time_zone object includes timezone offsets, date/date_time variants, current_time , current_time_unix , time_24 , time_12 , week , month , year , timezone abbreviations, and DST transition details.

Parameter	Required	Description
tz		IANA timezone name, such as America/New_York
lat + long		Latitude and longitude
location		City or address string
ip		IP address
iata_code		IATA airport code
icao_code		ICAO airport code
lo_code		UN/LOCODE
lang		Response language for IP-based lookups. Non-English values require a paid plan

This tool always goes upstream and is not cached because it returns current time.

Convert a time from one location to another.

Plan: free and paidCredits: 1

Choose this when:

Parameter	Required	Description
time		Time to convert in yyyy-MM-dd HH:mm or yyyy-MM-dd HH:mm:ss format. If omitted, we convert the current time
tz_from / tz_to		IANA timezone names
lat_from + long_from		Source coordinates
lat_to + long_to		Destination coordinates
location_from / location_to		Source and destination location strings
iata_from / iata_to		Source and destination IATA airport codes
icao_from / icao_to		Source and destination ICAO airport codes
locode_from / locode_to		Source and destination UN/LOCODEs

This tool always goes upstream and is not cached because it can default to the current time.

Sun and moon data for one location on one date.

Plan: free and paidCredits: 1

Choose this when:

Returns an object with location and astronomy . The astronomy object includes morning and evening twilight blocks, sunrise/sunset, solar noon, day length, moonrise/moonset, status fields, and the live sun/moon position fields for that date and location.

Parameter	Required	Description
lat + long		Latitude and longitude. Highest priority when provided
location		City or address
ip		IP address
date		Date in YYYY-MM-DD format. Defaults to today
elevation		Elevation in meters. Allowed range is 0 to 10000
time_zone		IANA timezone name to control time output
lang		Response language for IP-based lookups. Non-English values require a paid plan

This tool always goes upstream and is not cached because omitting date returns time-sensitive data.

Astronomy data for a date range.

Plan: free and paidCredits: 1 per request

Choose this when:

Returns an object with location and an astronomy array. Each daily entry includes mid_night , night_end , morning , sunrise , sunset , evening , night_begin , sun_status , solar_noon , day_length , moon_phase , moonrise , moonset , and moon_status .

Parameter	Required	Description
dateStart		Start date in YYYY-MM-DD format
dateEnd		End date in YYYY-MM-DD format. Maximum span is 90 days
lat + long		Latitude and longitude. Highest priority when provided
location		City or address
ip		IP address
elevation		Elevation in meters
time_zone		IANA timezone name to control time output
lang		Response language for IP-based lookups. Non-English values require a paid plan
force_refresh		Bypass the MCP cache and force a fresh upstream request

Parse one user-agent string.

Plan: paid onlyCredits: 1

Choose this when:

This MCP tool parses the explicit uaString value you provide. It does not infer a caller user-agent from the MCP connection.

Parameter	Required	Description
uaString		The user-agent string to parse
force_refresh		Bypass the MCP cache and force a fresh upstream request

Returns name , type , version , device , engine , and operating_system .

Parse multiple user-agent strings in one request.

Plan: paid onlyCredits: 1 per user-agent string

Choose this when:

This MCP tool parses only the explicit uaStrings values you provide.

Parameter	Required	Description
uaStrings		Array of user-agent strings
force_refresh		Bypass the MCP cache and force a fresh upstream request

The default cap is 1,000 items per MCP request. You can change it with IPGEOLOCATION_MCP_MAX_BULK_ITEMS .

Company and ASN holder lookup for one IP.

Plan: paid onlyCredits: 1

Choose this when:

If the same prompt also needs security, abuse, city, timezone, or network details, prefer lookup_ip with targeted fields and include modules.

Parameter	Required	Description
ip		IP address to look up
force_refresh		Bypass the MCP cache and force a fresh upstream request

Returns company and asn objects.

Currency and country metadata for one IP.

Plan: free and paidCredits: 1

Choose this when:

Parameter	Required	Description
ip		IP address to look up
force_refresh		Bypass the MCP cache and force a fresh upstream request

Returns currency and country_metadata .

Route and network details for one IP.

Plan: paid onlyCredits: 1

Choose this when:

Parameter	Required	Description
ip		IP address to look up
force_refresh		Bypass the MCP cache and force a fresh upstream request

Returns a network object with connection_type , route , and is_anycast .

Detailed ASN lookup.

Plan: paid onlyCredits: 1

Choose this when:

Call this once with the include set you need, then filter locally from the response instead of making repeat calls to reshape the same data.

Parameter	Required	Description
asn		ASN such as AS13335 or 13335
ip		IP address to resolve to an ASN
include		Extra data: peers , downstreams , upstreams , routes , whois_response
fields		Comma-separated fields to return
excludes		Comma-separated fields to exclude
force_refresh		Bypass the MCP cache and force a fresh upstream request

Abuse contact lookup for one IP.

Plan: paid onlyCredits: 1

Choose this when:

If the same prompt also needs geolocation or security data, prefer lookup_ip with targeted fields and include=abuse or include=security,abuse .

Parameter	Required	Description
ip		IP address to look up
fields		Comma-separated fields to return
excludes		Comma-separated fields to exclude
force_refresh		Bypass the MCP cache and force a fresh upstream request

Returns the abuse route, country, name, organization, address, emails, and phone numbers.