Energy Aspects MCP

Energy Aspects
MCP Server

Real-time energy market intelligence — publications, live analyst commentary, and time-series data — brought directly into your AI assistant.

4 tools Read-only OAuth 2.1 Streamable HTTP MCP 1.26

Overview

The Energy Aspects MCP server gives your AI assistant direct access to EA's research database, live market feed, and commodity datasets. Ask questions in natural language — the server handles search, retrieval, and citation automatically.

Energy Aspects is a leading independent energy research firm covering oil, gas, LNG, power markets.

Publications

Full research articles and analysis on oil, gas, LNG, power.

EA Live

Short-form real-time market updates and analyst commentary.

Time-series Data

Historical and forecast commodity datasets with supply/demand balances.

Cargo Tracking

Seaborne crude and LNG vessel flows via natural-language SQL (select plans).

Tools Reference

The server exposes 4 tools. All are read-only and require a valid OAuth session.

get_insight_and_data

Retrieve publications, EA Live posts, and timeseries data in a single parallel request. The preferred starting tool for broad or initial research questions.

Parameters

NameTypeRequiredDefaultDescription
query string required Natural-language or keyword description of the topic
from_ string optional Earliest date filter — yyyy-MM-dd or yyyy-MM-ddTHH:mm:ssZ
to string optional Latest date filter — same format as from_
limit integer optional 10 Number of results to return (1–50)
release_date string optional Filter timeseries by a specific release/revision date — yyyy-MM-dd
Example prompt

"What is EA's current view on the oil market balance for Q3 2025?"

get_publications

Retrieve Energy Aspects in-depth research publications and analysis via semantic search.

Parameters

NameTypeRequiredDefaultDescription
query string required Natural-language or keyword description of the topic
from_ string optional Earliest date filter — yyyy-MM-dd or yyyy-MM-ddTHH:mm:ssZ
to string optional Latest date filter — same format as from_
limit integer optional 10 Number of results to return (1–50)
Example prompt

"Get me the latest LNG market report from Energy Aspects."

get_ea_live_posts

Retrieve EA Live posts — short, real-time market updates and analyst commentary — via semantic search.

Parameters

NameTypeRequiredDefaultDescription
query string required Natural-language or keyword description of the topic
from_ string optional Earliest date filter — yyyy-MM-dd or yyyy-MM-ddTHH:mm:ssZ
to string optional Latest date filter — same format as from_
limit integer optional 10 Number of results to return (1–50)
Example prompt

"Any recent EA Live updates on China crude imports?"

get_timeseries_data

Retrieve Energy Aspects time-series datasets — historical values and forecasts for energy market metrics — via semantic search.

Parameters

NameTypeRequiredDefaultDescription
query string required Natural-language or keyword description of the topic
from_ string optional Earliest date filter — yyyy-MM-dd or yyyy-MM-ddTHH:mm:ssZ
to string optional Latest date filter — same format as from_
limit integer optional 10 Number of results to return (1–50)
release_date string optional Point-in-time query — return data as it appeared at this release date
Example prompt

"Show me EA's forecast for European natural gas storage levels through end of 2025."

EA MCP Skill

The EA MCP Skill is an instruction file that governs how AI agents use this server. It shapes what the agent retrieves, how it attributes and presents EA content, when it flags caveats, and when it routes to EA's analyst or client success teams.

MCP Resource

The Skill is served as an authenticated MCP resource. Clients that support resources/read can retrieve the full Skill file directly. Access requires a valid OAuth session.

MCP Resource URI
skill://ea_mcp_skill
Version v1.0 — June 2026. Proprietary. Contact success@energyaspects.com for licensing enquiries.

Authentication

All connections use OAuth 2.1. You will be redirected to the Energy Aspects login page the first time you connect — no manual token management required.

Session length

Sessions last 90 days. Re-authentication is automatic on expiry.

Single active session

Connecting from a new device invalidates the previous session.

Required account

Active Energy Aspects portal account with API / chatbot access enabled.

Read-only access

All tools are read-only — no data can be created, modified, or deleted.

Connect — Claude.ai & ChatGPT (Web)

MCP URL
https://mcp.energyaspects.com/mcp
Anthropic docs — Claude.ai OpenAI docs — ChatGPT

Connect — Cursor (Local)

json — ~/.cursor/mcp.json
{
  "mcpServers": {
    "energy-aspects": {
      "url": "https://mcp.energyaspects.com/mcp"
    }
  }
}
Official Cursor docs — Model Context Protocol

Connect — Claude Code (Local)

bash
claude mcp add energy-aspects --transport http https://mcp.energyaspects.com/mcp
Official Anthropic docs — Claude Code MCP

Connect — Custom Client (OAuth 2.1)

Any OAuth 2.1 + PKCE capable client can connect directly — with or without support for Dynamic Client Registration (DCR).

1. Discovery

Fetch the authorization server metadata to confirm endpoints and supported flows.

GET
GET https://mcp.energyaspects.com/.well-known/oauth-authorization-server

2. Register a client

If your client does not support DCR: skip this step — Energy Aspects will issue you a client_id and client_secret directly. Use those in place of the values registered above. Don't have one yet? Contact support@energyaspects.com.

If your client supports Dynamic Client Registration (RFC 7591):

POST — application/json
POST https://mcp.energyaspects.com/register
Content-Type: application/json

{
  "client_name": "My MCP Client",
  "redirect_uris": ["https://myapp.example.com/callback"],
  "grant_types": ["authorization_code", "refresh_token"],
  "response_types": ["code"],
  "token_endpoint_auth_method": "client_secret_post"
}

Typical response:

json
{
  "client_id": "generated-client-id",
  "client_secret": "generated-client-secret",
  "client_name": "My MCP Client",
  "redirect_uris": ["https://myapp.example.com/callback"],
  "grant_types": ["authorization_code", "refresh_token"],
  "response_types": ["code"],
  "token_endpoint_auth_method": "client_secret_post"
}

3. Authorization request

Redirect the user's browser here. After they authenticate, they're redirected back to your redirect_uri with code and state query params.

GET
GET https://mcp.energyaspects.com/authorize
    ?client_id=YOUR_CLIENT_ID
    &redirect_uri=REDIRECT_URL
    &state=RANDOM_OPAQUE_STATE
    &code_challenge=BASE64URL_SHA256_OF_VERIFIER
    &code_challenge_method=S256

4. Token exchange

POST — application/x-www-form-urlencoded
POST https://mcp.energyaspects.com/oauth/token
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code
&code=AUTH_CODE
&redirect_uri=REDIRECT_URL
&client_id=YOUR_CLIENT_ID
&client_secret=YOUR_CLIENT_SECRET
&code_verifier=ORIGINAL_PKCE_VERIFIER

Typical response:

json
{
  "access_token": "eyJ...",
  "refresh_token": "...",
  "id_token": "eyJ...",
  "token_type": "Bearer",
  "expires_in": 86400
}

5. Using the token

POST
POST https://mcp.energyaspects.com/mcp
Authorization: Bearer <access_token>
Content-Type: application/json

6. Refresh token

POST — application/x-www-form-urlencoded
POST https://mcp.energyaspects.com/oauth/token
Content-Type: application/x-www-form-urlencoded

grant_type=refresh_token
&refresh_token=YOUR_REFRESH_TOKEN
&client_id=YOUR_CLIENT_ID
&client_secret=YOUR_CLIENT_SECRET

7. Revocation

POST — application/x-www-form-urlencoded
POST https://mcp.energyaspects.com/oauth/revoke
Content-Type: application/x-www-form-urlencoded

token=YOUR_ACCESS_OR_REFRESH_TOKEN
&token_type_hint=refresh_token
&client_id=YOUR_CLIENT_ID
&client_secret=YOUR_CLIENT_SECRET
Need a client_id / client_secret pair without DCR? Contact support@energyaspects.com.

Support

Questions about your subscription, data access, or technical issues?