
AutoTS MCP Server: Time Series Forecasting for Claude, Cursor and Other Apps
Lets Claude, Cursor and other assistants load time series data and forecast it, find anomalies and estimate the risk of crossing a limit.
AutoTS is an open-source Python library for time series forecasting, and its MCP server lets your assistant run it. It runs on your computer and holds your data in memory between steps, passing IDs from one tool to the next.
The quick forecast returns in seconds. The full model search can take far longer and use a lot of memory.
Good for
- Analysts who want forecasts from a CSV without writing code
- Operations teams sizing stockout or capacity risk
- Data scientists who want an assistant to run AutoTS
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install autots MCP
Claude Code
- 1
Copy this prompt.
Add the autots MCP server to Claude Code. Run this command: claude mcp add autots -- uvx --from "autots[mcp]" autots-mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires uv, Python 3.10+.
The README runs pip install autots[mcp] and then autots-mcp; these configs run the same command through uvx. Plain uvx autots-mcp does not work, because the autots-mcp package only pulls in autots[mcp] and has no command of its own. The first run downloads a large set of scientific packages.
Built from the package data we hold. Not yet tested by us.
Tools
Lists saved data and forecasts
Shows every dataset, forecast, model and detector the server is holding in memory, with the IDs other tools need.
Try: “What data and forecasts are saved right now?”
Read ·
list_cacheClears saved results
Removes chosen objects, one type of cache or everything from the server's memory.
Try: “Clear all saved forecasts.”
Write ·
clear_cacheLoads a built-in dataset
Loads one of the example datasets, such as daily, hourly, weekly, monthly, yearly, linear, sine or artificial.
Try: “Load the monthly sample data.”
Read ·
load_sample_dataLoads FRED or stock data
Pulls live economic series from FRED or stock prices by ticker, over the internet.
Try: “Load the last 5 years of AAPL and MSFT prices.”
Network ·
load_live_dataMakes test series
Generates daily series with labeled trend, seasonality and noise parts, for testing.
Try: “Make a synthetic daily series with weekly seasonality.”
Read ·
generate_synthetic_dataLoads a CSV file or link
Reads a CSV from a local path or a web address. The first column must be the date.
Try: “Load /Users/me/sales.csv.”
Files ·
load_data_from_fileLoads pasted or uploaded data
Accepts pasted CSV or TSV text, a CSV link such as a published Google Sheet, or an uploaded CSV or XLSX. It removes empty rows and columns and works out wide versus long layout.
Try: “Here is my sales table, load it.”
Network ·
smart_loadReturns saved data
Returns saved data as JSON in wide or long form, or writes it to a CSV file.
Try: “Save the loaded data as sales_clean.csv.”
Write ·
get_dataReshapes data
Converts data with date, series ID and value columns into one column per series.
Try: “Convert my long data to wide format.”
Read ·
convert_long_to_wideFills gaps and outliers
Fills missing values and handles outliers using methods such as forward fill, mean, median, rolling mean or linear.
Try: “Fill missing values with linear interpolation.”
Read ·
clean_dataMakes a quick forecast
Runs a pre-set ensemble with no model search, so results come back in seconds. It returns an ID for the forecast.
Try: “Forecast the next 30 days quickly.”
Read ·
forecast_fastForecasts with readable models
Searches only models that explain themselves (Cassandra, TVVAR, BasicLinearModel), so you can see trend and seasonality.
Try: “Give me an explainable forecast I can break into parts.”
Read ·
forecast_explainableForecasts with your own settings
Runs the full AutoTS search with the parameters or model template you give. It takes longer than the quick option.
Try: “Run a full model search with a 5-minute budget.”
Read ·
forecast_customReturns forecast numbers
Returns the point forecast and upper and lower bounds as JSON or CSV.
Try: “Show me the forecast and its intervals.”
Read ·
get_forecastDraws the forecast
Plots the forecast with history and prediction intervals and returns the image.
Try: “Plot the forecast for series1.”
Read ·
plot_forecastLimits a forecast
Dampens growth, sets upper or lower bounds or clips by quantile, and saves the result as a new forecast.
Try: “Cap the forecast at 1000 and floor it at 0.”
Read ·
apply_constraintsNudges a forecast
Applies a linear ramp, aligns to the last value or smooths with an EWMA, and saves a new forecast.
Try: “Align the forecast start to the last actual value.”
Read ·
apply_adjustmentsShows which model made a forecast
Returns the model name, its settings and the transformations used for a forecast.
Try: “Which model produced this forecast?”
Read ·
get_model_paramsSplits a forecast into parts
Returns trend, seasonality and other components, for Cassandra and TVVAR models only.
Try: “Break the forecast into trend and seasonality.”
Read ·
get_forecast_componentsShows model rankings
Returns cross-validation results and the top models from a model search.
Try: “Which models won the search?”
Read ·
get_validation_resultsDraws validation forecasts
Plots the cross-validation forecasts from a model search and returns the image.
Try: “Plot the validation results.”
Read ·
plot_validationEstimates the chance of crossing a limit
Estimates the probability that a series passes a threshold in coming periods, such as a stockout or capacity breach.
Try: “What is the chance demand exceeds 500 next month?”
Read ·
forecast_event_riskReturns event risk numbers
Returns event risk probabilities as JSON or CSV.
Try: “Show the event risk probabilities.”
Read ·
get_event_risk_resultsDraws event risk
Plots the event probabilities across the forecast horizon.
Try: “Plot the event risk.”
Read ·
plot_event_riskFinds anomalies and patterns
Detects anomalies, changepoints, level shifts, holidays and seasonality in a series.
Try: “Find anomalies and level shifts in this series.”
Read ·
detect_featuresQueries what was found
Returns detected features, optionally limited to a date range or series.
Try: “Show anomalies from last quarter only.”
Read ·
get_detected_featuresDraws the detected features
Plots detected features on top of the time series.
Try: “Plot the detected features.”
Read ·
plot_featuresForecasts from detected parts
Experimental. Builds a forecast from the decomposed parts that feature detection found.
Try: “Forecast from the detected components.”
Read ·
forecast_from_features
Read from the source code
Permissions
medium risk · 3 things to watch
Medium risk
It reads CSV files and web addresses you point it at, and it can write CSV files, but it does not change anything outside that. Large model searches can use a lot of memory.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It reads local files and fetches web addresses
load_data_from_file takes a local path or URL, and smart_load takes a URL. Only point it at data you mean to share with the assistant. github.com
get_data can write a CSV file
Its save option writes a CSV to the path you give, which can replace an existing file. github.com
Big searches can crash on low memory
The README says memory shortage is the most common cause of random crashes. Try a data subset or a smaller model list. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Talks to | FRED and stock data sources (load_live_data). Any CSV URL you give it |
|---|---|
| Sign-in and keys | No credentials needed for the server. |
Questions
Is the AutoTS MCP server official?
Yes. It ships inside the AutoTS library itself, from the winedarksea/AutoTS repo, and is also listed in the MCP Registry.
Does it need an API key?
No key is needed for the server itself. load_live_data takes an optional fred_key (a FRED API key) when you pull FRED series.
Which install do I use, autots[mcp] or autots-mcp?
Use autots[mcp], as in uvx --from "autots[mcp]" autots-mcp. The README calls autots-mcp an equivalent convenience package, but that package only pulls in autots[mcp], so plain uvx autots-mcp does not start the server. The autots-mcp command itself comes from the main autots package.
Which forecast tool should I start with?
Start with the fast forecast, which needs no model search and returns in seconds. Use the explainable or custom forecasts when you need to see why a result came out as it did or tune the search.
Does it keep my data after it closes?
Its results live in a server-side cache that the README describes with IDs. The README does not describe saving that cache between sessions.
Does the README list all tools?
The README lists 28, but it names get_autots_docs where the code has smart_load. The 28 tools above come from the code of version 1.0.4.
Information
updated Nov 2, 2026
- Publisher
- Official
- Package
autots-mcp- Registry
- PyPI
- Transport
- stdio
- Auth
- None
- Version
- 1.0.1
- License
- MIT
- Last commit
- Oct 31, 2026
- Open issues
- 25
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 4Hide
- README.md · github.com
- README.md · github.com
- schemas_data.py · github.com
- schemas_forecast.py · github.com