TensorLink-AI/ephemeris-mcp

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 time-series foundation models (TSFMs) behind one API key, plus an accuracy-weighted ensemble of them:
| 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, better than every model it blends (a few leaderboard entries, including TimesFM-3, score better)
Scored with each benchmark's own harness. Details: ephemeris.cascade.industries/benchmarks.
Tools
| Tool | What it does |
|---|---|
| get_version | Public hosted server version, nullable build commit and supported artifact schemas; no key or inference |
| forecast | Forecast 1 to 64 series in one call: route, ensemble or explicit mode, any quantiles, optional covariates, horizons up to 4096 sampling steps (subject to live model limits and the 120,000 output-value budget) |
| describe_forecast | Deterministic interpretation of a saved artifact; no new inference |
| plot_forecast | Inline PNG by default, optional SVG, from a saved artifact; no new inference |
| list_models | The live panel: health, capabilities, horizon limits, ensemble weights, prices |
| get_balance | Spendable credits |
| get_usage | Recent requests and what each cost |
Get an API key
Quickest, from a terminal:
It opens Ephemeris in your browser. Sign in (or sign up), check the page shows the same code as your terminal, and approve. The key is saved to ~/.config/ephemeris/credentials, readable by you only, and the stdio bridge below uses it, with no key in your MCP config. The Ephemeris CLI (ephemeris auth login) and savetokens share the same file. npx ephemeris-mcp logout deletes it; revoke the key itself on the dashboard's API keys page.
Or sign up at ephemeris.cascade.industries 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)**
You are asked for your API key once; it is stored in your system's secure credential store.
**Claude Code (server only)**
**Cursor**: one click with , then replace YOUR_EPHEMERIS_API_KEY with your key in Cursor's MCP settings. Or add it by hand:
**Cursor (.cursor/mcp.json) and most clients**
**VS Code (.vscode/mcp.json)**
**Claude Desktop and other clients that only run local (stdio) servers**
After npx ephemeris-mcp login, no key goes in the config:
Or pass a key explicitly with "env": { "EPHEMERIS_API_KEY": "pc_live_your_key" }; it wins over the saved one.