# Constellation OS

> The control plane for space infrastructure: telemetry in, topology and forecasts out, through one API that people and AI agents share. Agents can connect directly through the MCP server at https://api.constellation.space/mcp.

## Api

- [Authentication](https://docs.constellation.space/api/authentication): Create scoped API keys and handle authentication failures.
- [Errors and limits](https://docs.constellation.space/api/errors-and-limits): Authentication lockout, rate limits, body caps, and retry rules.
- [Health](https://docs.constellation.space/api/health): The four unauthenticated health endpoints, what each one proves, and how to use them for monitoring alongside an authed key check.
- [API overview](https://docs.constellation.space/api/overview): Endpoints, credentials, and integration access.
- [Predictions](https://docs.constellation.space/api/predictions): Request model forecasts and handle per-entity results.
- [Telemetry](https://docs.constellation.space/api/telemetry): POST /telemetry ingests batches of time-series records, up to 1,000 per request, with a 202 acknowledgment and per-record rejection reporting.
- [Topology](https://docs.constellation.space/api/topology): GET /topology returns the latest-known state per entity from your telemetry, with freshness windows and point-in-time replay.

## Architecture

- [Console rendering](https://docs.constellation.space/architecture/console-rendering): How the console combines telemetry, orbital propagation, and analysis overlays.
- [Determinism](https://docs.constellation.space/architecture/determinism): Reproduce analyses by preserving inputs and evaluation settings.
- [Architecture overview](https://docs.constellation.space/architecture/overview): How telemetry, topology, predictions, and the console connect.

## Console

- [Assistant](https://docs.constellation.space/console/assistant): Supported assistant tools for fleet analysis, predictions, scenarios, and scene controls.
- [Demo mode](https://docs.constellation.space/console/demo-mode): Explore fleet analysis and simulated imaging missions with orbital compute.
- [Console overview](https://docs.constellation.space/console/overview): What the console is, how the scene works, and where to go next.
- [Reports](https://docs.constellation.space/console/reports): Capture analyses, add notes, and export reports.

## Examples

- [Connection smoke test](https://docs.constellation.space/examples/connection-smoke-test): Check health endpoints and make one authenticated topology read.
- [Ingest telemetry](https://docs.constellation.space/examples/ingest-telemetry): Write a current telemetry record and verify it in topology.
- [Examples](https://docs.constellation.space/examples/overview): Two small checks for API connectivity and telemetry ingestion.

## Faq

- [FAQ](https://docs.constellation.space/faq): Answers to common integration and analysis questions.

## Getting started

- [Environments](https://docs.constellation.space/getting-started/environments): Select the API endpoint and credentials for your deployment.
- [Quick start](https://docs.constellation.space/getting-started/quick-start): Go from a new API key to your first SNR forecast in about five minutes.

## Intelligence

- [Models](https://docs.constellation.space/intelligence/overview): The forecasting models behind Constellation OS, what to send each one, and what it returns.

## Platform

- [Concepts](https://docs.constellation.space/platform/concepts): Core vocabulary: accounts versus tenants, fleets and the topology projection, the unified asset model, measurement families, and the fleet agent.
- [Data model](https://docs.constellation.space/platform/data-model): Telemetry records, topology projections, and prediction results.
- [Platform overview](https://docs.constellation.space/platform/overview): The components of Constellation OS.

## Reference

- [Environment variables](https://docs.constellation.space/reference/environment-variables): The fleet-agent environment variables you set on a host that runs the agent.
- [URLs and hosts](https://docs.constellation.space/reference/urls-and-hosts): Public service URLs and Enterprise endpoint guidance.

## Security

- [Security overview](https://docs.constellation.space/security/overview): Account sign-in, API credentials, and Enterprise isolation.
- [Tenant isolation](https://docs.constellation.space/security/tenant-isolation): Tenant isolation is available with Enterprise.

## Tooling

- [Connect an AI agent (MCP)](https://docs.constellation.space/tooling/connect-an-ai-agent): Give Claude, Cursor, VS Code, Codex, Gemini CLI, or Grok live access to your fleet through the Constellation MCP server.
- [1. Install](https://docs.constellation.space/tooling/fleet-agent): Install the Constellation Fleet Agent on a supported Linux host and grant a publisher access to its local socket.
- [5. Equipment contracts — ACU and modem](https://docs.constellation.space/tooling/fleet-agent/equipment-contracts): The JSON an antenna control unit and a modem expose, the fields that matter, and the line-protocol telemetry a poller publishes from them.
- [4. Integrate an application](https://docs.constellation.space/tooling/fleet-agent/integrate-an-application): Connect a long-running application directly to the Fleet Agent Unix socket.
- [7. Operate a fleet](https://docs.constellation.space/tooling/fleet-agent/operations): Status, logs, verification, debug mode, upgrades, buffering, credentials, and uninstall for a deployed fleet agent.
- [6. Satellite contract](https://docs.constellation.space/tooling/fleet-agent/satellite-contract): Publish satellite identity and orbital elements from a ground-side producer.
- [2. Send one metric](https://docs.constellation.space/tooling/fleet-agent/send-one-metric): Encode, validate, and send a first telemetry metric through the local Fleet Agent.
- [8. Protocol reference](https://docs.constellation.space/tooling/fleet-agent/socket-protocol): The complete local ingest contract — discovery, framing, line protocol, types, escaping, timestamps, connection reuse, and limits.
- [9. Troubleshooting](https://docs.constellation.space/tooling/fleet-agent/troubleshooting): Permissions, parse errors, missing entity_id, clock errors, queueing, and the platform compatibility caveats that make correct usage surprising.
- [3. Verify it](https://docs.constellation.space/tooling/fleet-agent/verify): Prove telemetry travels from the local socket through ingest and back through topology.
- [Fleet SDK and tooling](https://docs.constellation.space/tooling/overview): Connect applications through the Fleet SDK, agent, and API.

## Troubleshooting

- [Troubleshooting](https://docs.constellation.space/troubleshooting): Resolve connection, telemetry, prediction, and saved-work issues.