Integrations · Claude

Connect Claude in two minutes

Fetch heating and cooling degree days inside Claude — for energy analysis, weather normalization, and portfolio benchmarking.

Example prompts

Try these after connecting. Copy, paste, and adjust the location or dates.

Get heating degree days for Berlin last January — metric, HDD base 15°C.

Compare cooling degree days for our three US sites over calendar year 2024.

How much of my connector allowance have I used this month?

Connect in Claude.ai

Add Energy-Data Degree Days as a custom connector — or use the official directory listing once approved.

Open Claude.ai → Settings → Connectors → Add custom connector
Server URL: https://mcp.energy-data.io/mcp
Complete OAuth sign-in with your Energy-Data.io account
Grant degree_days and usage_read scopes when prompted

Regional defaults (for your reference)

When specifying degree-day parameters, common standards are US/EIA (imperial, HDD/CDD base 65°F) and Europe/Eurostat (metric, HDD base 15°C, CDD base 24°C). End dates on or before yesterday avoid incomplete same-day weather.

Privacy and data handling

OAuth tokens authenticate your account. Tool calls are logged for allowance metering. See our privacy policy for details on API and MCP data processing.

Privacy policy: /privacy-policy/
API documentation: /api-documentation/
Connector pricing: /mcp/pricing/

Technical details for developers

Server URL

https://mcp.energy-data.io/mcp

Tools

Get Degree Days — get_degree_days

Returns heating or cooling degree days for one location and date range. Charges API credits based on method and span. Requires kind, method, unit, start, end, and location (lat/lon or country+zip).
Estimate Degree-Day Cost — estimate_degree_day_cost

Quotes API credits for one degree-day request with the same parameters as get_degree_days. Free preview — does not fetch weather data or charge credits.
Get API Usage Summary — get_api_usage_summary

Return the current API/MCP credit period and recent usage events for this API key owner. Requires usage_read scope.

Parameter-explicit prompts

Get heating degree days for Berlin (52.52, 13.4) from 2024-01-01 to 2024-01-31 using metric units, HDD base 15°C, mean method.

Estimate API credits for integration-method HDD at three US sites (New York, Chicago, Houston) for calendar year 2024.

Show my current API and MCP credit usage for this billing period.

Expected output (JSON-RPC)

Successful tools/call responses wrap the payload in MCP text content.

MCP response envelope

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ... tool JSON below, stringified ... }"
      }
    ]
  }
}

estimate_degree_day_cost (parsed JSON)

{
  "start": "2024-01-01",
  "end": "2024-01-02",
  "days": 2,
  "method": "mean",
  "kind": "hdd",
  "unit": "metric",
  "breakdown": "daily",
  "credits_per_day": 0.01,
  "estimated_credits": 0.02
}

get_degree_days — mean (parsed JSON)

{
  "type_of_degree_days": "Heating Degree Days",
  "calculation_method": "Daily Mean Temperature Method",
  "base_temperature": ["15"],
  "unit": "Celsius",
  "coordinates": { "latitude": "52.52", "longitude": "13.40" },
  "degree_days_data": [
    { "date": "2024-01-01", "temp": 2.5, "hdd(15.0)": 12.5 }
  ]
}

get_degree_days — minmax (parsed JSON)

{
  "type_of_degree_days": "Heating Degree Days",
  "calculation_method": "Min/Max Temperature Method",
  "base_temperature": ["15"],
  "unit": "Celsius",
  "coordinates": { "latitude": "52.52", "longitude": "13.40" },
  "degree_days_data": [
    { "date": "2024-01-01", "tempmin": -1.2, "tempmax": 4.8, "hdd(15.0)": 12.7 },
    { "date": "2024-01-02", "tempmin": 0.5, "tempmax": 6.1, "hdd(15.0)": 11.7 },
    { "date": "2024-01-03", "tempmin": 2.0, "tempmax": 7.4, "hdd(15.0)": 10.3 }
  ]
}

get_api_usage_summary (parsed JSON)

{
  "current_period": {
    "period_start": "2024-06-01",
    "period_end": "2024-06-30",
    "credits_limit": 1000,
    "credits_used": 12.5
  },
  "recent_events": [
    {
      "created_at": "2024-06-18T09:15:00.000Z",
      "surface": "mcp",
      "endpoint": "/mcp",
      "tool_name": "get_degree_days",
      "credit_cost": 0.62,
      "status": "success"
    }
  ]
}

View pricing All integrations Privacy policy