# Microsoft Planetary Computer — STAC catalog
# Path-as-id: registry/sources/stac/microsoft-pc.yaml resolves stac://microsoft-pc/<collection>

title: "Microsoft Planetary Computer"
endpoint: https://planetarycomputer.microsoft.com/api/stac/v1
homepage: https://planetarycomputer.microsoft.com/
operator: Microsoft

# Alternate short-names that resolve to this catalog.
# stac://planetary-computer/X and stac://mspc/X both land here.
aliases:
  - planetary-computer
  - mspc

auth:
  mode: sas-token
  signing_url: https://planetarycomputer.microsoft.com/api/sas/v1/token/{collection}
  notes: |
    The STAC API itself is open. Asset URLs in returned items require
    SAS tokens signed at request time (per collection). Tokens are
    short-lived (~1 hour) and renewable anonymously.

cors_enabled: true
egress_cost: free
region: westeurope, eastus

# Top collections by Folia recipe usage (2026-06-06 audit):
# landsat-c2-l2 (9), cop-dem-glo-30 (8), esa-worldcover (7), sentinel-2-l2a (6),
# deltares-floods (3), daymet-daily-na (2), plus 12 others.
notes: |
  Broadest collection coverage among free STAC mirrors (~120 collections).
  SAS-token gate on asset URLs adds one round-trip per scene fetch but
  keeps bytes anonymous-readable once signed. Use earth-search instead
  when the same collection is available there and the SAS overhead matters.