Geneva Forecasting™ API & MCP

forecast.py

# pip install geneva-forecast
import os
from geneva_forecast import GenevaClient

client = GenevaClient(
    api_url="https://api.roadmap-tech.com",
    api_key=os.environ["GENEVA_API_KEY"],
)

monthly_sales = [112.0, 118.4, 132.1, 124.3, 121.1, 140.2,
                 148.9, 153.7, 136.2, 119.0, 104.0, 118.5]  # your history

result = client.forecast(
    data=monthly_sales,
    horizon=12,                # periods ahead
    wave_periods=[12],         # monthly seasonality
    confidence_level=0.95,
    include=["forecast", "prediction_intervals", "metrics", "model_info"],
)

print(result.model_info.method_name)
print(f"MAPE: {result.metrics.mape:.2f}%")
for pt in result.prediction_intervals:
    print(pt.period, round(pt.forecast, 2), [round(pt.lower, 2), round(pt.upper, 2)])

curl -X POST https://api.roadmap-tech.com/forecast \
  -H "X-API-Key: $GENEVA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "data": [112.0, 118.4, 132.1, 124.3, 121.1, 140.2, 148.9, 153.7,
             136.2, 119.0, 104.0, 118.5, 121.3, 129.8, 138.5, 146.7,
             128.4, 155.3, 162.8, 149.1, 141.7, 119.5, 108.2, 126.3],
    "forecast_horizon": 12,
    "wave_periods": [12],
    "confidence_level": 0.95
  }'

claude_desktop_config.json

{
  "mcpServers": {
    "geneva": {
      "command": "uvx",
      "args": ["geneva-mcp"],
      "env": {
        "GENEVA_API_URL": "https://api.roadmap-tech.com",
        "GENEVA_API_KEY": "gva_your_key_here"
      }
    }
  }
}