# OrbitalStreams

OrbitalStreams — the world's vital signs as a service.

## Data Surface

- 125 live streams across 7 categories.
- Categories: Earth & Climate, Geology & Space, Disasters & Events, Human Activity, Humanitarian, Nature, Infrastructure.
- Data is sourced from public upstream APIs and refreshed per source cadence.

## Agent Entry Points

- REST API: /api/v1/*
- World state: /api/v1/world
- Stream catalog: /api/v1/streams
- Live anomalies: /api/v1/anomalies
- Risk index: /api/v1/risk
- Attribution: /api/v1/attribution
- Health: /api/v1/health
- OpenAPI spec: /api/v1/openapi.json
- MCP server: 6 read-only tools over stdio.
- CLI: command-line access for scripted world-state queries.

## Named Capabilities

- Live anomaly API for unusual conditions and source-level signals.
- Data Time Machine for historical snapshots and playback.
- Per-fetch validation plus attribution for every data source.

## Discovery

- Base URL: https://orbitalstreams.com
- OpenAPI: https://orbitalstreams.com/api/v1/openapi.json
- Recommended first call: /api/v1/world?lat=34.05&lon=-118.24

## License And Attribution

OrbitalStreams aggregates public data sources. Use /api/v1/attribution for upstream
provider licenses, credits, and source URLs.