Browse and query the U.S. Energy Information Administration API v2 — electricity, petroleum, natural gas, coal, forecasts, and more via MCP. STDIO or Streamable HTTP.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add eia-energy --env EIA_API_KEY='<EIA_API_KEY>' -- npx -y @cyanheads/eia-energy-mcp-server~/.codex/config.toml
[mcp_servers.eia-energy]
command = "npx"
args = ["-y", "@cyanheads/eia-energy-mcp-server"]
env = { EIA_API_KEY = "<EIA_API_KEY>" }
# codex mcp add eia-energy --env EIA_API_KEY='<EIA_API_KEY>' -- npx -y @cyanheads/eia-energy-mcp-server~/.cursor/mcp.json
{
"mcpServers": {
"eia-energy": {
"command": "npx",
"args": [
"-y",
"@cyanheads/eia-energy-mcp-server"
],
"env": {
"EIA_API_KEY": "<EIA_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"eia-energy": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/eia-energy-mcp-server"
],
"env": {
"EIA_API_KEY": "<EIA_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"eia-energy": {
"command": "npx",
"args": [
"-y",
"@cyanheads/eia-energy-mcp-server"
],
"env": {
"EIA_API_KEY": "<EIA_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"eia-energy": {
"command": "npx",
"args": [
"-y",
"@cyanheads/eia-energy-mcp-server"
],
"env": {
"EIA_API_KEY": "<EIA_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"eia-energy": {
"command": "npx",
"args": [
"-y",
"@cyanheads/eia-energy-mcp-server"
],
"env": {
"EIA_API_KEY": "<EIA_API_KEY>"
}
}
}
}Remote
claude mcp add --transport http eia-energy https://eia-energy.caseyjhand.com/mcp~/.codex/config.toml
[mcp_servers.eia-energy]
url = "https://eia-energy.caseyjhand.com/mcp"
# codex mcp add eia-energy --url https://eia-energy.caseyjhand.com/mcp~/.cursor/mcp.json
{
"mcpServers": {
"eia-energy": {
"url": "https://eia-energy.caseyjhand.com/mcp"
}
}
}.vscode/mcp.json
{
"servers": {
"eia-energy": {
"type": "http",
"url": "https://eia-energy.caseyjhand.com/mcp"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"eia-energy": {
"httpUrl": "https://eia-energy.caseyjhand.com/mcp"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"eia-energy": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://eia-energy.caseyjhand.com/mcp"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"eia-energy": {
"url": "https://eia-energy.caseyjhand.com/mcp"
}
}
}Environment variables
EIA_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.