01
Discover
Your agent sees available datasets, providers, zones, and coverage before choosing a source.
list_data_sources
Clarigrid MCP
Structured energy datafor AI agents.
Give MCP-compatible clients read-only access to Clarigrid U.S. electricity, gas, and weather APIs through one consistent interface.
Read-only accessSource provenanceWorks with leading MCP hosts
Example workflowConnected
User request
Summarize U.S. electricity demand during 1–2 January 2025.
Clarigrid tools
01 list_data_sources · provider=eia
02 describe_data · dataset=load
03 fetch_data · source=eia
Returned context
Timestamped rows, MW units, summary statistics, provider provenance, and pagination details.
Compatible clients
ClaudeChatGPTCursorVS CodeCodex
Capabilities
A predictable workflow from discovery to retrieval.
Three tools let agents inspect available sources and data contracts before fetching observations.
02
Understand
It checks columns, units, time index, options, and compatible providers before fetching.
describe_data
03
Fetch
It receives timestamped rows, summaries, units, provenance, and pagination in one response.
fetch_data
Dataset coverage
U.S. electricity, gas, carbon, and weather.
Supported families cover balancing-authority operations, forecasts, interchange, fuel markets, gas infrastructure, and weather.
Dataset catalog also available as read-only MCP resources
Electricity prices & demand
Balancing authority load
Generation & forecasts
Interchange & net positions
Grid capacity & frequency
Fuel production & consumption
CO₂ intensity
Renewable & generation shares
Natural gas flows & capacity
Gas storage & LNG inventory
Weather observations
Weather forecasts
One hosted connection
One URL. No installation.
Add Clarigrid in your AI agent’s connector settings. Your client handles the secure sign-in, and Clarigrid is ready to use.
Clarigrid MCP URL
https://mcp.clarigrid.energy/mcpHosted, read-only, and available in Claude, ChatGPT, Cursor, VS Code, and Codex.View client instructions
Safety and request limits.
Clarigrid exposes read-only data while keeping provider credentials private. Bounded requests make agent behavior easier to review.
Keys stay private
Provider API keys are never returned to the agent.
Read-only by design
Catalog and dataset resources cannot change source data.
Bounded results
Up to 1,000 rows per call and 31 days by default.
Source clarity
Agent must name a source when several providers match.
Reference
Advanced configuration
Most users only need the hosted connection above. Open these details for local development, provider keys, and service limits.
Install from a repository
Development install
cd /path/to/ClariGrid python -m pip install -e ".[mcp]" python -m clarigrid.mcp_server
Installed packages can start with clarigrid-mcp. Repository environments can use an absolute virtual-environment Python path, module argument, and repository working directory in client configuration.
Provider API keys
For the hosted server, add protected-provider keys in your Clarigrid account settings. Keys stay server-side and are never returned to the agent. Local installations can use standard environment variables:
Environment
export CLARIGRID_EIA_API_KEY="..."
Resources and response details
Read-only resources
clarigrid://catalogclarigrid://datasets/{dataset}Every fetch includes
Provider and zone provenance, columns, data types, units, min/max/mean/latest summaries, JSON-safe rows, and pagination.
Limits and availability
Maximum 1,000 returned rows per call. Default maximum date range: 31 days. Change the range with CLARIGRID_MCP_MAX_DAYS.
Custom Open-Meteo URLs are blocked. Provider-specific availability and rate limits still apply.
Connect Clarigrid to your MCP client
Add the hosted URL, authorize your Clarigrid account, then ask your first question.