# Alphacast

## Docs

- [GET /datasets/{id}/columns — List Dataset Columns](https://alphacastio.mintlify.app/api/datasets/columns.md): Retrieve just the column schema of a dataset — name, ID, data type, and whether the column is an entity/dimension — without the rest of the dataset metadata.
- [POST /datasets — Create a Dataset](https://alphacastio.mintlify.app/api/datasets/create.md): Create a new dataset in a repository to store tabular or time-series data. Requires name and repositoryId. Optionally add source metadata.
- [GET /datasets/{id}/data — Download Dataset Data](https://alphacastio.mintlify.app/api/datasets/data.md): Download dataset rows as CSV, JSON, XLSX, or TSV. Supports OData filtering, column selection, row limits, and transposing the output.
- [DELETE /datasets/{id} — Delete a Dataset](https://alphacastio.mintlify.app/api/datasets/delete.md): Permanently delete a dataset and all its data. Requires Write permission on the dataset. Returns 204 No Content. This action cannot be undone.
- [GET /datasets/{id} — Get a Dataset](https://alphacastio.mintlify.app/api/datasets/get.md): Retrieve a single dataset by numeric ID, including its name, repository, description, column schema, date range, and your permission level.
- [GET /datasets — List All Datasets](https://alphacastio.mintlify.app/api/datasets/list.md): Retrieve all datasets accessible to the authenticated user across all repositories. Returns an array of dataset objects with metadata.
- [PUT /datasets/{id}/data — Upload Data to a Dataset](https://alphacastio.mintlify.app/api/datasets/upload.md): Upload a CSV or gzip-compressed CSV file to add, update, or replace dataset rows. Supports a column manifest, conflict resolution flags, and async processing.
- [API Error Codes and Troubleshooting](https://alphacastio.mintlify.app/api/errors.md): Reference for every HTTP error code returned by the Alphacast API — 400, 401, 402, 403, 404, 409, 429, 500, 503, 504 — with causes, example responses, and fixes.
- [Alphacast REST API Reference](https://alphacastio.mintlify.app/api/overview.md): Explore the Alphacast REST API to manage repositories, datasets, and data providers programmatically from any HTTP client.
- [GET /providers — List and Browse Data Providers](https://alphacastio.mintlify.app/api/providers/list.md): List all available data providers, browse their hierarchical categories, search for series, and save provider API keys for authenticated access.
- [Fetch Series Data from External Providers](https://alphacastio.mintlify.app/api/providers/series.md): Preview or download complete time-series data from FRED, BLS, World Bank, OECD, IMF, BIS, ECB, Eurostat, and central banks across Latin America, Europe, and Asia using the Alphacast provider API.
- [POST /repositories — Create a Repository](https://alphacastio.mintlify.app/api/repositories/create.md): Create a new repository to organize datasets. Requires name and privacy. Optionally specify description and team for collaboration.
- [DELETE /repositories/{id} — Delete a Repository](https://alphacastio.mintlify.app/api/repositories/delete.md): Permanently delete a repository and all its datasets. Requires Owner permission. This action cannot be undone.
- [GET /repositories/{id} — Get a Repository](https://alphacastio.mintlify.app/api/repositories/get.md): Retrieve a single repository by its numeric ID. Returns the repository object including name, description, privacy, and your permission level.
- [GET /repositories/home — Get Home Repository](https://alphacastio.mintlify.app/api/repositories/home.md): Retrieve the authenticated user's Home repository — the default workspace where pipelines and datasets land when no specific repository is named.
- [GET /repositories — List All Repositories](https://alphacastio.mintlify.app/api/repositories/list.md): Retrieve all repositories accessible to the authenticated user. Returns an array of repository objects with id, name, privacy, and permission fields.
- [PUT /repositories/{id} — Update a Repository](https://alphacastio.mintlify.app/api/repositories/update.md): Update an existing repository's name, description, or privacy. Requires Owner permission. Returns the updated repository object on success.
- [Authenticate with the Alphacast API](https://alphacastio.mintlify.app/authentication.md): Learn how to authenticate Alphacast API requests using your API key via HTTP Basic Auth or as a query parameter, with examples in curl and Python.
- [Data Providers: Built-In Sources for Market Data](https://alphacastio.mintlify.app/concepts/data-providers.md): Alphacast ships built-in connectors for 30+ external sources — FRED, BLS, World Bank, OECD, IMF, BIS, ECB, Eurostat, Banxico, BCRA, and many more. Browse, search, and pull series through a single unified REST API.
- [Datasets: Storing and Accessing Time-Series Data](https://alphacastio.mintlify.app/concepts/datasets.md): Datasets hold tabular and time-series data inside Alphacast repositories. Upload CSV files, query with OData filters, and download in CSV, JSON, XLSX, or TSV.
- [Repositories: Organizing Your Data in Alphacast](https://alphacastio.mintlify.app/concepts/repositories.md): Repositories are the top-level containers in Alphacast. Every dataset you create belongs to a repository, and you control who can access it.
- [Alphacast: Financial Data Analytics for Everyone](https://alphacastio.mintlify.app/introduction.md): Alphacast is a financial data analytics platform for managing datasets and connecting to global data providers via API.
- [MCP Authentication](https://alphacastio.mintlify.app/mcp/authentication.md): How the Alphacast MCP server authenticates with your Alphacast API key via the ALPHACAST_API_KEY environment variable.
- [Connect Claude Code](https://alphacastio.mintlify.app/mcp/configuration/claude-code.md): Add the Alphacast MCP server to Claude Code with the claude mcp add command or by editing .mcp.json directly.
- [Connect Claude Desktop](https://alphacastio.mintlify.app/mcp/configuration/claude-desktop.md): Configure Claude Desktop to use the Alphacast MCP server via npx.
- [Connect Cursor](https://alphacastio.mintlify.app/mcp/configuration/cursor.md): Configure Cursor to use the Alphacast MCP server via .cursor/mcp.json.
- [Other MCP Clients](https://alphacastio.mintlify.app/mcp/configuration/other-clients.md): Connect VS Code, Zed, Windsurf, and any custom MCP client to the Alphacast MCP server.
- [MCP Examples](https://alphacastio.mintlify.app/mcp/examples.md): End-to-end prompt walkthroughs that combine multiple Alphacast MCP tools to solve realistic discovery and data-fetching tasks.
- [Alphacast MCP Server](https://alphacastio.mintlify.app/mcp/overview.md): Connect Claude Desktop, Claude Code, Cursor, and other MCP-compatible clients to Alphacast. Search the catalog, download datasets, browse 30+ data providers, look up tickers, and build pipelines from natural-language prompts.
- [MCP Quickstart](https://alphacastio.mintlify.app/mcp/quickstart.md): Connect Claude Code or Cursor to the Alphacast MCP server in three steps and run your first prompt.
- [Grapher & Chart Tools](https://alphacastio.mintlify.app/mcp/tools/grapher.md): Tools for looking up chart-authoring recipes, validating Grapher configurations, and inspecting existing chart metadata. Three read-only tools.
- [MCP Tools Overview](https://alphacastio.mintlify.app/mcp/tools/overview.md): Reference for all 32 tools exposed by the Alphacast MCP server, grouped by capability: search & datasets, providers, tickers, grapher & charts, and pipelines.
- [Pipeline Tools](https://alphacastio.mintlify.app/mcp/tools/pipelines.md): Build, inspect, edit, and run Alphacast pipelines from natural-language prompts. Thirteen MCP tools for the full pipeline lifecycle — nine read-only, four write — with auto-validation and auto-run after every mutation.
- [Provider Tools](https://alphacastio.mintlify.app/mcp/tools/providers.md): Tools for discovering 30+ external data providers (FRED, BLS, World Bank, OECD, IMF, BIS, ECB, Eurostat, and central banks across Latin America, Europe, and Asia), browsing their catalogs, and fetching series.
- [Search & Datasets Tools](https://alphacastio.mintlify.app/mcp/tools/search-and-datasets.md): Tools for discovering content in the Alphacast catalog, reading dataset metadata, schemas, and rows, and resolving the user's Home repository.
- [Ticker Tools](https://alphacastio.mintlify.app/mcp/tools/tickers.md): Look up market tickers, ETFs, indexes, and ISINs from an MCP client, fetch their profile metadata, and pull historical price data. Three read-only tools that pair naturally with the fetch-yahoo pipeline step.
- [MCP Troubleshooting](https://alphacastio.mintlify.app/mcp/troubleshooting.md): Common errors and fixes when connecting clients to the Alphacast MCP server, authenticating, or running tools.
- [Connect to External Data Providers](https://alphacastio.mintlify.app/providers/overview.md): Pull series from central banks, statistical agencies, market data sources, and international organizations through a single unified Alphacast API. Browse the live catalog at alphacast.io/explore/apis.
- [Authentication](https://alphacastio.mintlify.app/python-sdk/authentication.md): How the Alphacast Python SDK authenticates requests with your API key, plus best practices for storing the key safely.
- [Datasets](https://alphacastio.mintlify.app/python-sdk/datasets.md): List, look up, and inspect datasets with the Alphacast Python SDK — read metadata, columns, and date stats before uploading or downloading.
- [Downloading Data](https://alphacastio.mintlify.app/python-sdk/downloading.md): Pull dataset rows into your Python code as a pandas DataFrame, CSV, JSON, or XLSX, with optional date, entity, and variable filters.
- [Alphacast Python SDK](https://alphacastio.mintlify.app/python-sdk/overview.md): Install the Alphacast Python SDK and interact with repositories, datasets, series, and search from your Python code — no need to call the REST API directly.
- [Process Status](https://alphacastio.mintlify.app/python-sdk/processes.md): Poll the status of an upload process from the Alphacast Python SDK to know when your data is ready.
- [Python SDK Quickstart](https://alphacastio.mintlify.app/python-sdk/quickstart.md): Install the Alphacast Python SDK, create a repository, upload a pandas DataFrame, and download it back — in under five minutes.
- [API Reference](https://alphacastio.mintlify.app/python-sdk/reference.md): Method-by-method reference of the Alphacast Python SDK — every public class, method, and parameter.
- [Repositories](https://alphacastio.mintlify.app/python-sdk/repositories.md): Use the Alphacast Python SDK's repository client to list, look up, create, and delete repositories — the top-level containers for your datasets.
- [Search](https://alphacastio.mintlify.app/python-sdk/search.md): Find datasets across your repositories and Alphacast's public catalog using the Python SDK's search client.
- [Series](https://alphacastio.mintlify.app/python-sdk/series.md): Read metadata and data for a single Alphacast series by ID using the Python SDK.
- [Uploading Data](https://alphacastio.mintlify.app/python-sdk/uploading.md): Create datasets, declare their column schema, and upload pandas DataFrames or CSV strings to Alphacast using the Python SDK.
- [Get Started with Alphacast API](https://alphacastio.mintlify.app/quickstart.md): Get your API key, create a repository and dataset, upload data, and download it — all in under five minutes using the Alphacast API.
- [The Dataset Manifest](https://alphacastio.mintlify.app/uploading/manifest.md): How to define column types, entity columns, date format, and renames in the dataset manifest that drives every Alphacast upload.
- [Uploading Data: Overview](https://alphacastio.mintlify.app/uploading/overview.md): How dataset uploads work in Alphacast — the manifest, the upload lifecycle, and what to expect after a CSV is processed.
- [Validation Rules and Upload Modes](https://alphacastio.mintlify.app/uploading/validation.md): Every validation rule Alphacast runs against an uploaded CSV, and how the deleteMissingFromDB / onConflictUpdateDB / acceptNewColumns flags control row-level conflict resolution.