# BRAINIAC Satellite Imagery Cloud Assessment

> BRAINIAC Satellite Imagery Cloud Assessment is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.03/call, status unknown (last checked 2026-11-12).

Assesses cloud cover and usability of caller-supplied satellite imagery metadata, returning per-scene cloud cover percentage, assessment category, and suitability for analysis

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/space-intelligence/satellite-imagery-cloud-assess?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-satellite-imagery-cloud-assessment-694cab7c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Yr8tfc2di80fSIUPZgQYl

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 brainiac-satellite-imagery-cloud-assessment-694cab7c -d '<json body>'
```

Example prompt: Can you assess the cloud cover for this Sentinel-2 scene captured on 2026-11-01 at coordinates 48.8566°N, 2.3522°E — the scene ID is AOI1 and the reported cloud cover is 12%? I need to know if it's usable for analysis.

## When to prefer this

Use this endpoint when you need a fast, no-account, pay-per-call cloud cover and usability assessment of satellite imagery metadata without connecting to a commercial imagery provider. It is ideal for agents that already have image metadata or scene statistics and want a structured quality gate before running expensive downstream analysis like change detection or vegetation monitoring. It works without API keys or subscriptions, using only caller-supplied data.

## Known failure modes

- Missing or invalid image metadata causes incomplete assessment
- Truncated or malformed base64 file content returns an error
- Scene coordinates outside valid lat/lon range rejected
- TLE elements with stale epochs increase positional uncertainty and are flagged
- No commercial imagery is fetched — results depend entirely on caller-supplied metadata quality
- Very high cloud cover scenes flagged as not usable for analysis

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

A JSON object containing per-scene assessments with cloud cover percentage, assessment category (e.g. mostly_clear), usability flag, scene count, usable count, orbital model used, whether paid providers or commercial imagery were used, and a list of limitations and uncertainty notes about the analysis.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "asOf": {
   "type": "string",
   "maxLength": 40
  },
  "file": {
   "type": "object",
   "required": [
    "fileBase64"
   ],
   "properties": {
    "role": {
     "type": "string",
     "maxLength": 80
    },
    "filename": {
     "type": "string",
     "maxLength": 180,
     "minLength": 1
    },
    "mediaType": {
     "enum": [
      "text/plain",
      "text/csv",
      "application/json",
      "application/octet-stream"
     ],
     "type": "string"
    },
    "fileBase64": {
     "type": "string",
     "maxLength": 12000000,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "json": {
   "type": "string",
   "maxLength": 200000
  },
  "text": {
   "type": "string",
   "maxLength": 200000
  },
  "tles": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "name": {
      "type": "string",
      "maxLength": 160
     },
     "side": {
      "enum": [
       "before",
       "after",
       "left",
       "right",
       "a",
       "b"
      ],
      "type": "string"
     },
     "text": {
      "type": "string",
      "maxLength": 400
     },
     "epoch": {
      "type": "string",
      "maxLength": 40
     },
     "line1": {
      "type": "string",
      "maxLength": 120
     },
     "line2": {
      "type": "string",
      "maxLength": 120
     },
     "source": {
      "type": "string",
      "maxLength": 200
     },
     "noradId": {
      "type": "string",
      "maxLength": 20
     }
    },
    "additionalProperties": false
   },
   "maxItems": 200
  },
  "files": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "fileBase64"
    ],
    "properties": {
     "role": {
      "type": "string",
      "maxLength": 80
     },
     "filename": {
      "type": "string",
      "maxLength": 180,
      "minLength": 1
     },
     "mediaType": {
      "enum": [
       "text/plain",
       "text/csv",
       "application/json",
       "application/octet-stream"
      ],
      "type": "string"
     },
     "fileBase64": {
      "type": "string",
      "maxLength": 12000000,
      "minLength": 1
     }
    },
    "additionalProperties": false
   },
   "maxItems": 20
  },
  "images": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLeng
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "id": "I1",
    "source": "Caller-supplied",
    "sceneId": "AOI1",
    "satellite": "Sentinel-2",
    "assessment": "mostly_clear",
    "capturedAt": "2026-11-01",
    "cloudCoverPct": 12,
    "usableForAnalysis": true,
    "cloudCoverPctSupplied": true,
    "commercialImageryUsed": false
   }
  ],
  "status": "assessed",
  "findings": [],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "sceneCount": 1,
  "limitations": [
   "Orbital elements, observers, imagery metadata, weather rows, and catalog objects are copied only from labeled fields supplied by the caller, or from key-free CelesTrak GP / Open-Meteo responses when explicitly requested.",
   "No commercial satellite imagery provider or paid orbital API is used and no API key is required.",
   "Pass and conjunction geometry use a simplified Keplerian propagator from TLE mean elements, not full SGP4/SDP4. Treat timing and miss-distance values as approximate and communicate residual orbital uncertainty.",
   "TLE freshness is reported from the element epoch when parseable. Stale elements increase positional uncertainty.",
   "Earth-observation change, cloud, quality, and license results use only caller-supplied image metadata/statistics. Pixels are not downloaded from commercial archives."
  ],
  "usableCount": 1,
  "orbitalModel": "simplified-keplerian-from-tle-mean-elements",
  "apiKeyRequired": false,
  "celestrakFetched": false,
  "openMeteoFetched": false,
  "paidProviderUsed": false,
  "paidOrbitalApiUsed": false,
  "commercialImageryUsed": false,
  "orbitalUncertaintyNote": "Positions and pass times are approximate. Simplified Keplerian propagation from TLE mean elements omits drag and perturbation modeling used by SGP4. Uncertainty grows with element age."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-satellite-imagery-cloud-assessment-694cab7c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
