# Ipinfo.io — how to use (mcp.ai)

Connect your Ipinfo.io account and use 27 tools for developer tools straight from your AI agent. Connect with your own API key. IPinfo.io provides a comprehensive API for IP address geolocation and related data.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_ipinfo_io?ms=1787295900000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `ipinfo_io_batch_lite_lookup`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/ipinfo_io`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/ipinfo_io/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/ipinfo_io/batch/lite/lookup` — Perform bulk Lite IP lookups for up to 1000 IPs in a single request. Returns lightweight IP information including ASN (Autonomous System Number), AS organization details, and geolocation (country and 
  - body: { queries: string[] }
- `POST https://api.mcp.ai/api/ipinfo_io/batch/lookup` — Perform batch IP lookups to retrieve geolocation and ASN information for multiple IPs in a single request. Use this tool when you need to look up multiple IP addresses efficiently. Supports up to 1000
  - body: { ips: string[], filter?: boolean }
- `POST https://api.mcp.ai/api/ipinfo_io/get/abuse/contact` — Retrieve abuse contact and organization information for an IP address. Use this tool when you need to identify who owns an IP address or find contact information for reporting malicious activity. Note
  - body: { ip: string }
- `POST https://api.mcp.ai/api/ipinfo_io/get/carrier/info` — Retrieves mobile carrier information for a given IP address. Returns the carrier name, Mobile Country Code (MCC), and Mobile Network Code (MNC) for mobile network IPs. For non-mobile IPs (e.g., datace
  - body: { ip: string }
- `POST https://api.mcp.ai/api/ipinfo_io/get/city/by/ip` — Retrieve the city name for a specific IP address. Returns the city name as plain text for any IPv4 or IPv6 address.
  - body: { ip: string }
- `POST https://api.mcp.ai/api/ipinfo_io/get/company/info` — Retrieve company/organization information for an IP address. Returns the company name, domain, and type (business, ISP, hosting, etc.) associated with the IP. Supports both IPv4 and IPv6 addresses.
  - body: { ip: string, token?: string, callback?: string }
- `POST https://api.mcp.ai/api/ipinfo_io/get/core/field/by/me` — Retrieve a specific field from core IP information about the current IP. Use this tool when you need just one specific piece of information (like city, country, hostname, or AS details) about the call
  - body: { field: string }
- `POST https://api.mcp.ai/api/ipinfo_io/get/country/by/ip` — Retrieve the two-letter ISO 3166 country code for an IP address. Use when you need to quickly identify which country an IP address is located in without requesting full geolocation details.
  - body: { ip: string }
- `POST https://api.mcp.ai/api/ipinfo_io/get/current/ip` — Retrieve the current public/external IP address. Use this tool when you need to determine the caller's public IP address.
- `POST https://api.mcp.ai/api/ipinfo_io/get/current/ip/info` — Retrieve comprehensive IP information about the caller's current IP address. Returns geolocation (city, region, country, coordinates, postal code, timezone), ASN details, company info, privacy detecti
- `POST https://api.mcp.ai/api/ipinfo_io/get/current/loc` — Retrieve geographic coordinates for the current IP address. Returns the latitude and longitude of the caller's IP address as a comma-separated string in the format 'latitude,longitude'. Use this when 
- `POST https://api.mcp.ai/api/ipinfo_io/get/current/region` — Retrieve the region/state for the caller's current IP address. Use this tool when you need to identify the geographic region or state where the current IP address is located. Returns a plain text regi
- `POST https://api.mcp.ai/api/ipinfo_io/get/geo/by/ip` — Get geolocation data only for an IP address. Returns city, region, country, continent, coordinates, timezone, and postal code. Use this when you need detailed geographic location information for an IP
  - body: { ip: string }
- `POST https://api.mcp.ai/api/ipinfo_io/get/hostname/by/ip` — Retrieve the hostname (reverse DNS) for an IP address. Use this tool to look up the hostname associated with any IPv4 or IPv6 address. Returns the hostname as a string. If no hostname is available, re
  - body: { ip: string }
- `POST https://api.mcp.ai/api/ipinfo_io/get/ip/by/ip` — Retrieve the IP address for a specified IP as plain text. Use this tool to echo back an IP address from the IPInfo API. This endpoint returns the IP address as plain text (not JSON). Useful for verify
  - body: { ip: string }
- `POST https://api.mcp.ai/api/ipinfo_io/get/ip/info` — Retrieve geolocation and ASN information for an IP address. Use this tool to look up country, continent, and Autonomous System (AS) details for any IPv4 or IPv6 address. Pass 'me' or omit the ip param
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipinfo_io/get/ip/info/by/ip` — Retrieve comprehensive information about a specified IP address. Returns geographic location (city, region, country, coordinates), ASN details, company/organization info, privacy detection flags (VPN,
  - body: { ip: string }
- `POST https://api.mcp.ai/api/ipinfo_io/get/lite/field/by/ip` — Retrieve a specific field from lightweight IP information. Use this tool to get a single piece of information about an IP address (e.g., just the country, or just the ASN) without fetching the full IP
  - body: { ip: string, field: string }
- `POST https://api.mcp.ai/api/ipinfo_io/get/location/by/ip` — Retrieve geographic coordinates (latitude, longitude) for an IP address. Returns location as comma-separated text in the format 'latitude,longitude'. Use when you need precise geolocation coordinates 
  - body: { ip: string }
- `POST https://api.mcp.ai/api/ipinfo_io/get/org/by/ip` — Retrieve ASN and organization name for an IP address as plain text. Use this tool when you need to quickly identify which organization or ASN owns a specific IP address. Returns a plain text string co
  - body: { ip: string }
- `POST https://api.mcp.ai/api/ipinfo_io/get/plus/field/by/me` — Retrieve a specific field from plus IP information about the current IP. Use this tool to get individual fields from IPInfo's Plus API for your current IP address. This includes detailed geographic da
  - body: { field: string }
- `POST https://api.mcp.ai/api/ipinfo_io/get/postal/by/ip` — Retrieve the postal/zip code for an IP address. Use this when you need to identify the geographic postal code associated with an IPv4 or IPv6 address.
  - body: { ip: string }
- `POST https://api.mcp.ai/api/ipinfo_io/get/privacy/details` — Retrieve privacy/anonymous IP detection flags for an IP address. Returns whether the IP is associated with VPN, proxy, Tor, relay, or hosting services. Use this to detect potentially anonymous or mask
  - body: { ip: string }
- `POST https://api.mcp.ai/api/ipinfo_io/get/region/by/ip` — Retrieve the region/state for a specified IP address. Use this tool when you need to identify the geographic region or state where a specific IPv4 or IPv6 address is located. Returns a plain text regi
  - body: { ip: string }
- `POST https://api.mcp.ai/api/ipinfo_io/get/timezone/by/ip` — Retrieve the IANA timezone for a given IP address. Use this tool when you need to determine the local timezone of an IP address location for scheduling, time conversion, or geographic analysis purpose
  - body: { ip: string }
- `POST https://api.mcp.ai/api/ipinfo_io/get/token/info` — Retrieve API service request limit information by access token. Returns usage statistics, request limits, remaining quota, and available API features. Use this to check your token's rate limits, curre
- `POST https://api.mcp.ai/api/ipinfo_io/map/ips` — Create an IPinfo map visualization from a list of IP addresses. Use this tool to generate an interactive map showing the geographic locations of multiple IP addresses. The tool accepts up to 500,000 I
  - body: { cli?: integer, ip_addresses: string[] }

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

## More
- Page: https://mcp.ai/ipinfo_io
- Agent spec (llms.txt): https://mcp.ai/ipinfo_io/llms.txt
- Postman collection: https://mcp.ai/ipinfo_io/postman.json