# IPGeolocation.io — MCP server on mcp.ai
> Connect your IPGeolocation.io account and use 13 tools for developer tools straight from your AI agent. Connect with your own API key. IPGeolocation.io provides IP geolocation, threat intelligence, ASN, abuse contact, timezone, User-Agent, and astronomy data.

By: mcp.ai · official
Page: https://mcp.ai/ipgeolocation

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_ipgeolocation?ms=1787293500000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/ipgeolocation/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/ipgeolocation/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/ipgeolocation/skill.md
Postman collection (v2.1): https://mcp.ai/ipgeolocation/postman.json

## Tools
- ipgeolocation_bulk_lookup_ip_geolocation(fields?: string[], language?: string, enrichments?: string[], exclude_fields?: string[], ips_or_domains: string[]) — Return geolocation results for 1-50 explicit IP addresses or domains in one paid request, preserving input order and per-item errors. Credits apply per valid item and optional enrichment.
- ipgeolocation_bulk_lookup_ip_security(ips: string[], fields?: string[], exclude_fields?: string[]) — Return threat intelligence for 1-50 IPv4 or IPv6 addresses in one paid request, preserving order and per-item errors. Costs 2 credits per valid item.
- ipgeolocation_bulk_parse_user_agents(user_agents: string[]) — Parse 1-50 custom User-Agent strings in one paid request and return one ordered parser result per input. Costs 1 credit per string.
- ipgeolocation_convert_timezone(time?: string, source_value?: string, selector_type: string, source_latitude?: number, source_longitude?: number, destination_value?: string, destination_latitude?: number, destination_longitude?: number) — Convert a supplied or current wall-clock time between two explicit timezone, place, coordinate, airport-code, or UN/LOCODE selectors of the same family. Costs 1 credit on success.
- ipgeolocation_get_execution_egress_ip() — Return the public IP observed for the Composio execution environment. This is not the end user's device or browser IP.
- ipgeolocation_lookup_asn(fields?: string[], include?: string[], lookup_type: string, lookup_value: string, exclude_fields?: string[]) — Return detailed autonomous-system metadata for one explicit IP address or ASN number, with optional topology, routes, and WHOIS data. Requires paid ASN access and costs 1 credit on success.
- ipgeolocation_lookup_astronomy(date?: string, language?: string, latitude?: number, longitude?: number, time_zone?: string, selector_type: string, selector_value?: string, elevation_meters?: number) — Return Sun, Moon, twilight, golden-hour, and positional data for one explicit location and date. Costs 1 credit on success.
- ipgeolocation_lookup_astronomy_time_series(end_date: string, language?: string, latitude?: number, longitude?: number, time_zone?: string, start_date: string, selector_type: string, selector_value?: string, elevation_meters?: number) — Return daily Sun, Moon, twilight, and golden-hour events for one explicit location over an inclusive range of at most 90 days. Costs 1 credit per request, not per day.
- ipgeolocation_lookup_ip_abuse_contact(ip: string, fields?: string[], exclude_fields?: string[]) — Return registry abuse contact details for one explicit IPv4 or IPv6 address, including organization, address, emails, and phone numbers. Requires paid Abuse access and costs 1 credit on success.
- ipgeolocation_lookup_ip_geolocation(fields?: string[], language?: string, enrichments?: string[], ip_or_domain: string, exclude_fields?: string[]) — Return location, timezone, currency, ASN, and optional paid enrichments for one explicit IPv4 address, IPv6 address, or domain. Costs 1 credit on success, plus 2 for Security and 1 for Abuse enrichmen
- ipgeolocation_lookup_ip_security(ip: string, fields?: string[], exclude_fields?: string[]) — Return threat score and Tor, proxy, VPN, relay, bot, spam, attacker, and cloud-provider signals for one explicit IPv4 or IPv6 address. Requires paid Security access and costs 2 credits on success.
- ipgeolocation_lookup_timezone(language?: string, latitude?: number, longitude?: number, selector_type: string, selector_value?: string) — Return current date, time, UTC offsets, and DST details for one explicit timezone, place, coordinate pair, IP, airport code, or UN/LOCODE. Costs 1 credit on success.
- ipgeolocation_parse_user_agent(user_agent: string) — Parse one explicit User-Agent string using the operation available on the free plan. Returns browser/client, device, engine, and operating-system details and consumes 1 credit on success.

## Example prompts
- "What can I do in IPGeolocation.io?"
- "Show me a summary of my IPGeolocation.io account"

## Links
Docs: https://mcp.ai/docs/mcps/ipgeolocation
Website: https://mcp.ai/mcps/ipgeolocation