ipdata MCP by usefulapi

Geolocation and network data for one IP address: city, region, country, continent, coordinates, postal code, time zone, currency, languages, mobile carrier, ASN, plus company and threat data where the key's plan includes them. Pass `fields` to get only some of it. The reply also carries `count`, the requests this key made in the last 24 hours. GET /{ip}. Uses 1 request of the key's daily ipdata quota and is never retried.

{
  "type": "object",
  "properties": {
    "ip": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "A public IPv4 or IPv6 address, for example 8.8.8.8. Required: ipdata never looks up this server's own address."
    },
    "fields": {
      "description": "Only these top-level fields (for example [\"ip\", \"country_name\", \"asn\"]). Omit for the full reply that the key's plan includes.",
      "minItems": 1,
      "maxItems": 24,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "ip",
          "is_eu",
          "city",
          "region",
          "region_code",
          "country_name",
          "country_code",
          "continent_name",
          "continent_code",
          "latitude",
          "longitude",
          "asn",
          "company",
          "postal",
          "calling_code",
          "flag",
          "emoji_flag",
          "emoji_unicode",
          "carrier",
          "languages",
          "currency",
          "time_zone",
          "threat",
          "count"
        ]
      }
    }
  },
  "required": [
    "ip"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Threat profile of one IP address: is_tor, is_proxy, is_anonymous, is_datacenter, is_known_attacker, is_known_abuser, is_threat, is_bogon, is_icloud_relay and the blocklists it appears on. Business and Enterprise plans also get is_vpn and reputation scores (vpn, proxy, threat and trust, 0-100). GET /{ip}/threat. Uses 1 request of the key's daily ipdata quota and is never retried.

{
  "type": "object",
  "properties": {
    "ip": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "A public IPv4 or IPv6 address, for example 8.8.8.8. Required: ipdata never looks up this server's own address."
    }
  },
  "required": [
    "ip"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

The autonomous system that announces one IP address: AS number, organisation name, domain, network route and usage type (hosting, isp, edu, gov, mil, business). GET /{ip}/asn. Uses 1 request of the key's daily ipdata quota and is never retried.

{
  "type": "object",
  "properties": {
    "ip": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "A public IPv4 or IPv6 address, for example 8.8.8.8. Required: ipdata never looks up this server's own address."
    }
  },
  "required": [
    "ip"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

The end-user organisation that a network is assigned to: name, domain, network prefix and usage type. Needs the ipdata Startup plan or higher. GET /{ip}/company. Uses 1 request of the key's daily ipdata quota and is never retried.

{
  "type": "object",
  "properties": {
    "ip": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "A public IPv4 or IPv6 address, for example 8.8.8.8. Required: ipdata never looks up this server's own address."
    }
  },
  "required": [
    "ip"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Details of one autonomous system: organisation, domain, usage type, IPv4 and IPv6 prefixes, number of IPs, registry, country, allocation date, status, and upstream, downstream and peer AS numbers. GET /AS{number}. Uses 1 request of the key's daily ipdata quota and is never retried.

{
  "type": "object",
  "properties": {
    "asn": {
      "type": "string",
      "minLength": 1,
      "maxLength": 14,
      "description": "An AS number, for example AS15169 or 15169."
    }
  },
  "required": [
    "asn"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Look up up to 100 IP addresses in one call (paid ipdata plans only). Duplicates are removed first. Replies are a list in the same order, one entry per address. Each address uses 1 request of the daily quota (100 addresses = 100 requests). Use `fields` to keep the reply small. POST /bulk. The call is never retried.

{
  "type": "object",
  "properties": {
    "ips": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 60,
        "description": "A public IPv4 or IPv6 address, for example 8.8.8.8. Required: ipdata never looks up this server's own address."
      },
      "description": "1 to 100 public IP addresses."
    },
    "fields": {
      "description": "Only these top-level fields (for example [\"ip\", \"country_name\", \"asn\"]). Omit for the full reply that the key's plan includes.",
      "minItems": 1,
      "maxItems": 24,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "ip",
          "is_eu",
          "city",
          "region",
          "region_code",
          "country_name",
          "country_code",
          "continent_name",
          "continent_code",
          "latitude",
          "longitude",
          "asn",
          "company",
          "postal",
          "calling_code",
          "flag",
          "emoji_flag",
          "emoji_unicode",
          "carrier",
          "languages",
          "currency",
          "time_zone",
          "threat",
          "count"
        ]
      }
    }
  },
  "required": [
    "ips"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}