Energy Aspects
MCP Server
Real-time energy market intelligence — publications, live analyst commentary, and time-series data — brought directly into your AI assistant.
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
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
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
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
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
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
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
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
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.
skill://ea_mcp_skill
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)
https://mcp.energyaspects.com/mcp
Connect — Cursor (Local)
{
"mcpServers": {
"energy-aspects": {
"url": "https://mcp.energyaspects.com/mcp"
}
}
}
Connect — Claude Code (Local)
claude mcp add energy-aspects --transport http https://mcp.energyaspects.com/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 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 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:
{
"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 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 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:
{
"access_token": "eyJ...",
"refresh_token": "...",
"id_token": "eyJ...",
"token_type": "Bearer",
"expires_in": 86400
}
5. Using the token
POST https://mcp.energyaspects.com/mcp
Authorization: Bearer <access_token>
Content-Type: application/json
6. Refresh token
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 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
Support
Questions about your subscription, data access, or technical issues?