Skip to main content
Glama
TensorLink-AI

Ephemeris MCP server

Official

Ephemeris MCP server: time-series forecasting for AI agents

Give Claude, Cursor, ChatGPT or any MCP client the ability to forecast numeric time series with prediction intervals: sales, demand, inventory, web traffic, signups, revenue, energy load, prices, sensor readings, infrastructure metrics.

Ephemeris runs a panel of open-weights, zero-shot forecasting foundation models behind one API key:

Model

Publisher

Use by name

Chronos-2

Amazon

chronos2

TimesFM 2.5

Google Research

timesfm25

Toto 2

Datadog

toto2-313m

TiRex-2

NXAI

tirex2

PatchTST-FM r2

IBM Granite

patchtst-fm-r2

FlowState r1

IBM Granite

flowstate-r1

Send history, get quantile forecasts back. No training, no feature engineering, no GPU. Name a model, let Ephemeris route to the best fit for your data, or use the ensemble, an accuracy-weighted blend of the panel:

  • TIME: level with the top of the leaderboard (MASE 0.639 vs 0.638 for the leader), with the best average MASE rank of 31 models

  • GIFT-Eval: CRPS 0.4662 against seasonal naive, ahead of every open-licence model

Scored with each benchmark's own harness. Details: ephemeris.cascade.industries/benchmarks.

Tools

Tool

What it does

forecast

Forecast 1 to 64 series in one call: route, ensemble or explicit mode, any quantiles, optional covariates, horizons up to 512 steps

list_models

The live panel: health, capabilities, horizon limits, ensemble weights, prices

get_balance

Spendable credits

get_usage

Recent requests and what each cost

Related MCP server: Nixtla MCP Server

Get an API key

Sign up at ephemeris.cascade.industries, add credits, and create a key (pc_live_...) in the dashboard. Pay per forecast, no subscription: pricing.

Connect

Remote server (Streamable HTTP): https://ephemeris.cascade.industries/api/mcp, header Authorization: Bearer pc_live_...

Claude Code (plugin: MCP server plus a forecasting skill)

/plugin marketplace add TensorLink-AI/ephemeris-mcp
/plugin install ephemeris@ephemeris

You are asked for your API key once; it is stored in your system's secure credential store.

Claude Code (server only)

claude mcp add --transport http ephemeris https://ephemeris.cascade.industries/api/mcp \
  --header "Authorization: Bearer pc_live_your_key"

Cursor (.cursor/mcp.json) and most clients

{
  "mcpServers": {
    "ephemeris": {
      "url": "https://ephemeris.cascade.industries/api/mcp",
      "headers": { "Authorization": "Bearer pc_live_your_key" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "ephemeris": {
      "type": "http",
      "url": "https://ephemeris.cascade.industries/api/mcp",
      "headers": { "Authorization": "Bearer pc_live_your_key" }
    }
  }
}

Claude Desktop and other clients that only run local (stdio) servers

{
  "mcpServers": {
    "ephemeris": {
      "command": "npx",
      "args": ["-y", "ephemeris-mcp"],
      "env": { "EPHEMERIS_API_KEY": "pc_live_your_key" }
    }
  }
}

OpenAI Responses API, Anthropic Messages API, Codex, Gemini CLI: see the docs.

Try it

Once connected, ask:

  • "Here are my last 18 months of sales: … Forecast the next 6 months with an 80% interval."

  • "Forecast next week's hourly traffic from this CSV and tell me the likely peak."

  • "Use the ensemble to project daily signups for 90 days; plot the median and the 10th to 90th percentile band."

More in examples/prompts.md. Without MCP, the same forecast is one REST call: examples/rest_forecast.py.

Reference

The code in this repository (the plugin manifest, skill and stdio bridge) is MIT-licensed. The models keep their own licences, listed on each model page.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables time-series analysis and forecasting through a structured tool catalogue, including data loading, quality repair, diagnostics, and forecasting with ARIMA, exponential smoothing, Chronos-2, Toto 2.0, and AutoML.
    1
    MIT