{
  "info": {
    "name": "IPGeolocation.io — mcp.ai",
    "description": "REST API for the IPGeolocation.io MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/ipgeolocation",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "ipgeolocation_bulk_lookup_ip_geolocation",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/bulk/lookup/ip/geolocation",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "bulk",
            "lookup",
            "ip",
            "geolocation"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"fields\": \"\",\n  \"language\": \"\",\n  \"enrichments\": \"\",\n  \"exclude_fields\": \"\",\n  \"ips_or_domains\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ipgeolocation_bulk_lookup_ip_security",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/bulk/lookup/ip/security",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "bulk",
            "lookup",
            "ip",
            "security"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ips\": \"\",\n  \"fields\": \"\",\n  \"exclude_fields\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ipgeolocation_bulk_parse_user_agents",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/bulk/parse/user/agents",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "bulk",
            "parse",
            "user",
            "agents"
          ]
        },
        "description": "Parse 1-50 custom User-Agent strings in one paid request and return one ordered parser result per input. Costs 1 credit per string.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"user_agents\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ipgeolocation_convert_timezone",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/convert/timezone",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "convert",
            "timezone"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"time\": \"\",\n  \"source_value\": \"\",\n  \"selector_type\": \"\",\n  \"source_latitude\": 0,\n  \"source_longitude\": 0,\n  \"destination_value\": \"\",\n  \"destination_latitude\": 0,\n  \"destination_longitude\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ipgeolocation_get_execution_egress_ip",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/execution/egress/ip",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "execution",
            "egress",
            "ip"
          ]
        },
        "description": "Return the public IP observed for the Composio execution environment. This is not the end user's device or browser IP.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ipgeolocation_lookup_asn",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/lookup/asn",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "lookup",
            "asn"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"fields\": \"\",\n  \"include\": \"\",\n  \"lookup_type\": \"\",\n  \"lookup_value\": \"\",\n  \"exclude_fields\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ipgeolocation_lookup_astronomy",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/lookup/astronomy",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "lookup",
            "astronomy"
          ]
        },
        "description": "Return Sun, Moon, twilight, golden-hour, and positional data for one explicit location and date. Costs 1 credit on success.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"date\": \"\",\n  \"language\": \"\",\n  \"latitude\": 0,\n  \"longitude\": 0,\n  \"time_zone\": \"\",\n  \"selector_type\": \"\",\n  \"selector_value\": \"\",\n  \"elevation_meters\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ipgeolocation_lookup_astronomy_time_series",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/lookup/astronomy/time/series",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "lookup",
            "astronomy",
            "time",
            "series"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"end_date\": \"\",\n  \"language\": \"\",\n  \"latitude\": 0,\n  \"longitude\": 0,\n  \"time_zone\": \"\",\n  \"start_date\": \"\",\n  \"selector_type\": \"\",\n  \"selector_value\": \"\",\n  \"elevation_meters\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ipgeolocation_lookup_ip_abuse_contact",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/lookup/ip/abuse/contact",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "lookup",
            "ip",
            "abuse",
            "contact"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ip\": \"\",\n  \"fields\": \"\",\n  \"exclude_fields\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ipgeolocation_lookup_ip_geolocation",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/lookup/ip/geolocation",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "lookup",
            "ip",
            "geolocation"
          ]
        },
        "description": "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",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"fields\": \"\",\n  \"language\": \"\",\n  \"enrichments\": \"\",\n  \"ip_or_domain\": \"\",\n  \"exclude_fields\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ipgeolocation_lookup_ip_security",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/lookup/ip/security",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "lookup",
            "ip",
            "security"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ip\": \"\",\n  \"fields\": \"\",\n  \"exclude_fields\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ipgeolocation_lookup_timezone",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/lookup/timezone",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "lookup",
            "timezone"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"language\": \"\",\n  \"latitude\": 0,\n  \"longitude\": 0,\n  \"selector_type\": \"\",\n  \"selector_value\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ipgeolocation_parse_user_agent",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/parse/user/agent",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "parse",
            "user",
            "agent"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"user_agent\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}