Skip to main content

EnergyScope MCP Server — AI agent tools for energy market data and analytics

Project description

energyscope-mcp

MCP server for AI agents to search, forecast, and analyse energy market data via EnergyScope.

17 tools: search 1.4M series, multi-factor XGBoost forecasts, Prophet, ARIMA, Theta, breakpoint detection, correlation, volatility, cointegration, and more.

Quick Start

# No install needed — uvx runs it directly
claude mcp add energyscope -- uvx energyscope-mcp

# Set your server and API key
export ENERGYSCOPE_SERVER=grpc+tls://data.energyscope.io:443
export ENERGYSCOPE_API_KEY=your-api-key

Then ask Claude: "What's the latest WTI price and has there been a regime change?"

Tools

Data (6): search, get_data, latest, browse, datasets, health

Analytics (11): forecast, arima, prophet, theta, breakpoints, stats, volatility, correlation, unit_root, cointegration

Cross-series alignment

Cross-series tools (forecast, spread, crack_spread, correlation, rolling_correlation, cointegration, var, lpirf, elastic_net, midas, correlate_all, changes) auto-truncate every input series to the freshest common date and emit a ⚠ ALIGNMENT: banner explaining what was dropped — no more silently regressing yesterday's stale predictor onto today's fresh target.

For batch / risk scripts that should hard-fail on freshness mismatch:

import os; os.environ["ENERGYSCOPE_STRICT_ALIGN"] = "1"
from energyscope_mcp import AlignmentError
try:
    spread("PET.RWTC.D", "NG.RNGWHHD.D")
except AlignmentError as e:
    page_data_team(e.series, e.lag_days)  # e.latest_common, e.error_code also available

Full reference: docs/cross-series-alignment.md

Links

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

energyscope_mcp-2.10.8.tar.gz (63.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

energyscope_mcp-2.10.8-py3-none-any.whl (46.8 kB view details)

Uploaded Python 3

File details

Details for the file energyscope_mcp-2.10.8.tar.gz.

File metadata

  • Download URL: energyscope_mcp-2.10.8.tar.gz
  • Upload date:
  • Size: 63.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for energyscope_mcp-2.10.8.tar.gz
Algorithm Hash digest
SHA256 1a77b767425b9ba11e0fc5dd205cbdb335df6ee963c573901bb75b60b787aea6
MD5 7364ef6c4264c062516a25a1aead2a3e
BLAKE2b-256 2f5d7365b41790efdab6624dc3ce6b1ae54030d0e5748a1e9a90cf973f4e7cd4

See more details on using hashes here.

File details

Details for the file energyscope_mcp-2.10.8-py3-none-any.whl.

File metadata

File hashes

Hashes for energyscope_mcp-2.10.8-py3-none-any.whl
Algorithm Hash digest
SHA256 85994e58952373d770324f72517dff001c5338c04332a6ff0fa45abe11fb3272
MD5 57c0c59375ef75be4ccaba26a59ff253
BLAKE2b-256 093da2f6e8236ea62f7c7dfc4e38bb4ddb8306e79275afa26f62a03230cc30ac

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page