sktime-mcp

Read the Official Documentation | PyPI Package

The Semantic Engine for Time-Series

Enables Large Language Models to discover, reason about, and execute sktime's advanced forecasting algorithms on real-world data.

Why sktime-mcp? Combines LLM reasoning with time-series precision. Instead of hallucinating Python code, your agent interacts with a strictly typed, safe, and stateful API to perform complex forecasting tasks.

👋 Who is this for?

sktime‑mcp is designed for:

Developers building LLM agents that need reliable, production‑grade time‑series forecasting.
Data scientists who want to expose sktime workflows to language models without unsafe code generation.
Platform teams integrating forecasting capabilities into tools like Claude Desktop, Cursor, or custom MCP clients.

If you are new to MCP‑based workflows, start with the Quick Start below, then explore the Use Cases and User Guide for deeper examples.

🔥 Key Features

Semantic Discovery: Find the perfect estimator using semantic similarity and capability tags (e.g., “probabilistic forecaster that handles missing data”).
Safe Composition: Build complex pipelines (Transformer → Forecaster) with built-in validation to ensure components are compatible before execution.
Universal Data Loading: Seamlessly ingest data from SQL, Pandas, Parquet, Excel, and CSV files.
Execution Runtime: Stateful engine that manages object lifecycles, fitting, and predicting, all via simple JSON-RPC tools.

⚡ Quick Start

Get up and running in seconds. Use with Claude Desktop, Cursor, or any MCP-compatible client.

1. Install

Zero-install via uvx (recommended): if you have uv installed, skip this step — uvx fetches and runs the package automatically when your MCP client starts.

# Or install explicitly with pip
pip install sktime-mcp

When contributing, install from source:

git clone https://github.com/sktime/sktime-mcp.git
cd sktime-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

2. Connect (Claude Desktop / Claude Code Config)

Add this to your claude_desktop_config.json:

With uvx (no prior install needed):

{
  "mcpServers": {
    "sktime": {
      "command": "uvx",
      "args": ["sktime-mcp"]
    }
  }
}

With pip-installed package:

{
  "mcpServers": {
    "sktime": {
      "command": "sktime-mcp"
    }
  }
}

📚 Documentation Map

Section	Description
Use Cases	Step-by-step workflows for coders and business users.
User Guide	Comprehensive manual on using tools, workflows, and best practices.
Usage Examples	Example scripts and advanced usage patterns.
Background Jobs	Running long operations asynchronously.
Data Sources	Comprehensive guide to loading data from SQL, Files, and Pandas.
Architecture	High-level system design, data flow, and limitations.
Implementation	Detailed code walkthrough and file breakdown.
Developer Guide	Contributing guidelines, testing, and extending the server.

🚀 Get Started

See Use Cases for step-by-step workflows.
See User Guide for detailed instructions and advanced features.

Get Started Now{ .md-button .md-button–primary }