# Ipdata.co — how to use (mcp.ai)

Connect your Ipdata.co account and use 28 tools for developer tools straight from your AI agent. Connect with your own API key. ipdata provides a simple HTTP-based API that allows you to look up the location, ownership, and threat profile of any IP address.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_ipdata_co?ms=1787295780000`
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. `ipdata_co_advanced_asn_lookup`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/ipdata_co`
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/ipdata_co/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/ipdata_co/advanced/asn/lookup` — Tool to perform advanced ASN lookup returning prefixes, peers, and registry details. Use after confirming ASN number when detailed ASN info is required.
  - body: { asn: integer, fields?: string }
- `POST https://api.mcp.ai/api/ipdata_co/eu/lookup/specific/ip` — Lookup geolocation, threat intel, and network data for a specific IP address using the EU data residency endpoint. Use this tool when: - You need IP lookup with GDPR compliance (data processed and sto
  - body: { ip: string, fields?: string, callback?: string }
- `POST https://api.mcp.ai/api/ipdata_co/field/calling/code` — Tool to fetch the international calling_code for an IP's country. Use when you need only the calling code field from ipdata_co.
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipdata_co/field/carrier` — Retrieve mobile carrier information (name, MCC, MNC) for an IP address. Returns carrier data only for mobile network IPs; non-mobile IPs return null fields.
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipdata_co/field/city` — Tool to return only city for an IP. Use when only the city name is required.
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipdata_co/field/continent/code` — Retrieve the continent code for a given IP address. Returns a two-letter code (AF, AN, AS, EU, NA, OC, SA) indicating which continent the IP is geographically located in. Use this when you only need t
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipdata_co/field/continent/name` — Tool to return only continent name for an IP. Use when only the continent name is required.
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipdata_co/field/count` — Tool to return only the request count made by your API key in the last 24 hours. Use when monitoring your API usage and you only need the total count.
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipdata_co/field/country/code` — Tool to return only country_code for an IP. Use when only the 2-letter country code is required.
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipdata_co/field/country/name` — Get the country name for an IP address using ipdata.co geolocation API. Returns only the country name (e.g., 'United States', 'Germany', 'Japan'). Use this lightweight action when you only need the co
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipdata_co/field/currency` — Tool to return only currency object for an IP. Use when currency details are needed.
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipdata_co/field/emoji/flag` — Tool to return only emoji flag for an IP. Use when only the country flag emoji is required.
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipdata_co/field/emoji/unicode` — Tool to return only emoji_unicode for an IP. Use when only the Unicode country flag emoji is required.
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipdata_co/field/ip` — Retrieve the public IP address of the calling client. This action calls the IPData API to determine the caller's external/public IP address. It returns only the IP string with no additional geolocatio
- `POST https://api.mcp.ai/api/ipdata_co/field/is/eu` — Tool to return only is_eu for an IP. Use when you need to determine if an IP's country belongs to the EU.
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipdata_co/field/languages` — Tool to return only the languages array for an IP. Use when only language details for an IP are required.
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipdata_co/field/latitude` — Tool to return only the latitude for an IP. Use when only the latitude coordinate is needed.
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipdata_co/field/longitude` — Tool to return only longitude for an IP. Use when only the longitude value is required.
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipdata_co/field/postal` — Tool to return only postal code for an IP. Use when only the postal code (ZIP/postcode) is required.
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipdata_co/field/region` — Tool to return only region for an IP. Use when only the region name is required.
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipdata_co/field/region/code` — Tool to return only region_code for an IP. Use when only the ISO 3166-2 region code is required.
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipdata_co/field/threat` — Retrieve threat intelligence data for a specific IP address or the calling IP. Returns indicators such as Tor exit node status, proxy detection, datacenter/cloud provider identification, known attacke
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipdata_co/field/time/zone` — Tool to return only the time_zone object for an IP. Use when only timezone data is required.
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/ipdata_co/ip/data/basic/asn/for/ip` — Tool to return basic ASN data for a specific IP. Use when you need ASN number, organization, domain, route, and type details.
  - body: { ip: string }
- `POST https://api.mcp.ai/api/ipdata_co/ip/data/company/for/ip` — Tool to retrieve company data for a given IP address. Use when you need the organization name, domain, network prefix, and usage type for an IPv4 or IPv6.
  - body: { ip: string }
- `POST https://api.mcp.ai/api/ipdata_co/ip/data/lookup/ip/v1` — Tool to lookup comprehensive IP information (geolocation, network, company, and threat data) in one call. Use when you need all IP insights together.
  - body: { ip: string, fields?: string, callback?: string }
- `POST https://api.mcp.ai/api/ipdata_co/ipdata/bulk/lookup/v1` — Tool to bulk lookup up to 100 IP addresses via ipdata.co. Use when you have multiple IPs and need geolocation and threat data in one call.
  - body: { ips: string[] }
- `POST https://api.mcp.ai/api/ipdata_co/ipdata/eu/lookup/calling/ip` — Lookup geolocation, network, and threat data for the calling client's IP address using the EU-residency endpoint. Use this action when you need IP data processed and stored entirely within the Europea
  - body: { fields?: string }

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

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