# The Forecasting Company

> Foundation models for time-series forecasting, behind a REST API at
> `https://api.retrocast.com`. Every page below is also served as HTML at
> the same path without the `.md` suffix.

## Forecasting API

- [Overview](https://docs.retrocast.com/documentation.md): What the API is, how to authenticate, and the table of available models.
- [Endpoints](https://docs.retrocast.com/documentation/endpoints.md): The five endpoints, sync vs async inference, and how to poll a job.
- [Covariates](https://docs.retrocast.com/documentation/covariates.md): Passing your own covariates, and the holiday/event/temporal features we add.
- [Model-specific configuration](https://docs.retrocast.com/documentation/model-config.md): Per-model options: which models take exogenous variables, quantiles, context length.
- [Python SDK](https://docs.retrocast.com/documentation/python-sdk.md): Installing and using the `theforecastingcompany` package.
- [Error handling](https://docs.retrocast.com/documentation/errors.md): Error response shape, status codes, and what to retry.

## Beta API

- [Introduction](https://docs.retrocast.com/api-v1/contents/intro.md): The v1 beta API — a newer request shape, not yet stable.
- [Cookbook](https://docs.retrocast.com/api-v1/contents/cookbook.md)
- [Backtest on past dates](https://docs.retrocast.com/api-v1/contents/cookbook/backtesting.md)
- [Add extra data like weather or prices](https://docs.retrocast.com/api-v1/contents/cookbook/covariates.md)
- [Group rows before forecasting](https://docs.retrocast.com/api-v1/contents/cookbook/hierarchy-rollups.md)
- [Forecast several columns at once](https://docs.retrocast.com/api-v1/contents/cookbook/multiple-targets.md)
- [Send a parquet file](https://docs.retrocast.com/api-v1/contents/cookbook/parquet-sources.md)
- [Forecast weekly or monthly totals](https://docs.retrocast.com/api-v1/contents/cookbook/time-rollups.md)

## MCP

- [Retrocast MCP](https://docs.retrocast.com/mcp.md): Your Retrocast workspace as tools, over OAuth. Not this gateway.

## Optional

- [Full documentation corpus](https://docs.retrocast.com/llms-full.txt): every page above, concatenated into one file.
- [OpenAPI specification](https://api.retrocast.com/openapi): the served spec, as JSON.
- [Docs MCP server](https://docs.retrocast.com/mcp/docs/docs-mcp): search these docs from an MCP client.