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.9.tar.gz (66.4 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.9-py3-none-any.whl (48.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: energyscope_mcp-2.10.9.tar.gz
  • Upload date:
  • Size: 66.4 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.9.tar.gz
Algorithm Hash digest
SHA256 454dd3d07da01de95c195bd89526e980606af839b0d989676a40fbbf9c677ad8
MD5 b0cc25fec4cfa13606a32f26e902acc6
BLAKE2b-256 35a9ec181c2f8c137db479d26d2518ded3e3b03eba192cddd698df94c054ca13

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for energyscope_mcp-2.10.9-py3-none-any.whl
Algorithm Hash digest
SHA256 9592aeac44c13a2759b219c2ab928093c2ed93bbd6e73f206eb558bba778d04b
MD5 2d23bdaa4256207b15796a55bd085e0f
BLAKE2b-256 a41d8d8aa346e01ded0c9e930205742ab3da6602a41cbd8d1b850e706091b330

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