# MolCloud IP Geolocation Lookup

> MolCloud IP Geolocation Lookup is a paid API for AI agents from api.molcloud.net, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-17).

Looks up geolocation and ASN data for a given IP address, returning country, ASN, and network metadata.

## Facts

- Endpoint: GET https://api.molcloud.net/api/security/ip-geo?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/molcloud-ip-geolocation-lookup-a3623ac4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bcGhHljIA67sI1eQJD3Qp

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability molcloud-ip-geolocation-lookup-a3623ac4
```

Example prompt: What country and ASN is the IP address 203.0.113.42 associated with? I need the geolocation details.

## When to prefer this

Choose this endpoint when you need lightweight, pay-per-use IP geolocation and ASN lookup with no subscription, settling in USDC on Base via x402. Ideal for AI agents that need to enrich incoming request metadata, detect geographic origin for fraud or compliance purposes, or identify network operators on demand without maintaining a database subscription.

## Known failure modes

- Invalid IP address format returns an error
- Missing or malformed query parameter may return a 400 error
- Unpaid or failed x402 payment returns a 402 Payment Required response
- Rate limiting or quota exhaustion may return a 429 error
- IP address not found in geolocation database may return empty or null data fields

## How this service works

41 pay-per-request AI, search, headless browser, crypto alpha & memory APIs for autonomous agents settling in USDC on Base via x402 v2.

## Output

Returns a JSON object with the queried IP address, its ASN number, and the country code it is associated with, plus a status field and the endpoint path. Example: {"report":{"ip":"1.1.1.1","asn":13335,"country":"US"},"status":"success","endpoint":"/api/security/ip-geo"}.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "ip": {
       "type": "string",
       "description": "Optional IP address to inspect"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "required": [
      "status",
      "endpoint"
     ],
     "properties": {
      "data": {
       "type": "object"
      },
      "payer": {
       "type": "string"
      },
      "status": {
       "enum": [
        "success"
       ],
       "type": "string"
      },
      "endpoint": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "report": {
   "ip": "1.1.1.1",
   "asn": 13335,
   "country": "US"
  },
  "status": "success",
  "endpoint": "/api/security/ip-geo"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/molcloud-ip-geolocation-lookup-a3623ac4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.molcloud.net](https://www.zero.xyz/host/api.molcloud.net/llms.txt)