mcp-perception

Fetch the least-cloudy Sentinel-2 L2A tile covering a given H3 cell from Microsoft Planetary Computer. Returns signed COG band URLs for all 6 Prithvi/Clay spectral bands (B02 Blue, B03 Green, B04 Red, B8A NIR, B11 SWIR1, B12 SWIR2), plus tile metadata. The tile is cached in memory for subsequent perception_classify or perception_embed calls.

{
  "type": "object",
  "properties": {
    "h3_cell": {
      "type": "string",
      "description": "H3 cell ID at any resolution."
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 datetime. Search back from this point. Defaults to now."
    },
    "max_cloud_cover": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Max cloud cover %. Default: 20."
    },
    "days_back": {
      "type": "number",
      "minimum": 1,
      "maximum": 365,
      "description": "Days to search back. Default: 30."
    }
  },
  "required": [
    "h3_cell"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Run Prithvi-EO-2.0-300M-TL-Sen1Floods11 flood classification on a Sentinel-2 tile previously fetched by perception_fetch_tile. Sends the 6-band chip to a RunPod endpoint and returns: dominant_class, flood_pixel_pct, confidence, class_counts, and the full perception_chain. The perception chain is written to Spatial Memory and a signed audit breadcrumb is dropped to the agent trail.

{
  "type": "object",
  "properties": {
    "tile_id": {
      "type": "string",
      "description": "tile_id from perception_fetch_tile result (must be in session cache)."
    },
    "task": {
      "type": "string",
      "enum": [
        "flood",
        "landcover",
        "burnscar",
        "anomaly"
      ],
      "description": "Classification task. Currently only \"flood\" is supported."
    },
    "h3_cell": {
      "type": "string",
      "description": "Override H3 cell. Defaults to the cell from the original fetch."
    },
    "write_to_spatial_memory": {
      "type": "boolean",
      "description": "Write perception chain to geiant_geometry_state. Default: true."
    }
  },
  "required": [
    "tile_id",
    "task"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

[Sub-phase 4.2 — NOT YET IMPLEMENTED] Will generate Clay v1.5 embeddings.

{
  "type": "object",
  "properties": {
    "tile_id": {
      "type": "string",
      "description": "tile_id from perception_fetch_tile result"
    }
  },
  "required": [
    "tile_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Query atmospheric conditions for an H3 cell at a given timestamp from Open-Meteo ERA5. Returns wind, precipitation, temperature. Writes to Spatial Memory and drops a signed audit breadcrumb.

{
  "type": "object",
  "properties": {
    "h3_cell": {
      "type": "string",
      "description": "H3 cell ID at any resolution."
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 datetime for weather lookup. Defaults to now."
    },
    "write_to_spatial_memory": {
      "type": "boolean",
      "description": "Write weather context to geiant_geometry_state. Default: true."
    }
  },
  "required": [
    "h3_cell"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get the current TierGate trust tier and score for an agent. Tiers: provisioned (0%) → observed (25%) → trusted (60%) → certified (85%) → sovereign (99%). Omit agent_pk to query the server's own agent.

{
  "type": "object",
  "properties": {
    "agent_pk": {
      "type": "string",
      "description": "Ed25519 public key (64 hex chars). Omit for own agent."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Verify the cryptographic integrity of an agent's breadcrumb chain. Returns { is_valid, block_count, issues[] } plus epoch Merkle roots. A valid chain proves no audit records have been tampered with.

{
  "type": "object",
  "properties": {
    "agent_pk": {
      "type": "string",
      "description": "Ed25519 public key (64 hex chars). Omit for own agent."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Roll all pending breadcrumbs into a new sealed epoch with a Merkle root. Returns { epoch_index, merkle_root, block_count, epoch_hash }. Call this at the end of a session to produce a tamper-evident compliance snapshot.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns a full EU AI Act compliance report for a GNS agent, including trust score, chain verification, Merkle epoch proofs, delegation certificate, and regulatory status.

{
  "type": "object",
  "properties": {
    "agentHandle": {
      "type": "string",
      "description": "GNS handle of the agent (e.g. energy@italy-geiant)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}