Use PG&E Data Portals with your AI.
Connect your account once and let the AI you already use work with it, without building another integration. Search and query PG&E energy datasets: usage, EV adoption, solar, grid data.
Developed, maintained, and hosted by Vinkius.
MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED
Waiting for input…
Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.
Complete set · 10 capabilities
The complete PG&E Data Portals capability set.
These are the exact actions your AI can choose when you ask it to work with PG&E Data Portals.
01-04
4 capabilities in this set.
Part of 10 available through PG&E Data Portals.
- 01
Query solar generation
Use this to analyze solar adoption and production trends. Region can be a county name or service area identifier. Year is YYYY format. Query solar energy generation data by region and year
- 02
Search datasets
Use this to discover available datasets before querying specific data. Returns dataset names, descriptions, IDs, and metadata. Optional query parameter filters results by keyword. Search the PG&E Data Portals catalog for energy datasets
- 03
List all datasets
Each dataset includes name, description, ID, and metadata. Use this as a starting point to explore what data is available from PG&E. includes energy usage, EV adoption, solar generation, energy efficiency programs, and grid infrastructure datasets. List all available datasets in the PG&E Data Portals catalog
- 04
Query dataset
Optional filters can be passed as key-value pairs to narrow results (e.g., zip_code, year, region). Use this to retrieve actual data records from any dataset in the PG&E Data Portals. Dataset IDs are obtained from search_datasets or list_all_datasets. Query a specific PG&E dataset with optional filters
05-07
3 capabilities in this set.
Part of 10 available through PG&E Data Portals.
- 05
Query grid infrastructure
Use this to understand grid capacity, identify areas needing upgrades, or analyze reliability metrics. Region filters by geographic area. dataType can filter by specific infrastructure type. Query PG&E grid infrastructure and distribution data
- 06
Query by date range
Specify the dataset ID and start/end dates to retrieve records within that time period. Use this for time-series analysis across any dataset type. Dataset ID from search_datasets. Dates in YYYY-MM-DD format. This is useful for year-over-year comparisons and trend analysis. Query any PG&E dataset filtered by a specific date range
- 07
Get dataset schema
Use this to understand what columns and data types are available before querying. The datasetId is obtained from search_datasets or list_all_datasets. Get the schema/metadata for a specific PG&E dataset
08-10
3 capabilities in this set.
Part of 10 available through PG&E Data Portals.
- 08
Query ev adoption
Use this to analyze EV adoption trends, identify high-adoption areas, and correlate with charging infrastructure. ZIP code is 5-digit format. Year is YYYY format (e.g., "2024"). Query electric vehicle adoption data by ZIP code and year
- 09
Query energy efficiency
), and investment amounts. Use this to analyze program effectiveness and ROI of energy efficiency initiatives. Optional programType filters by program category. Year is YYYY format. Query PG&E energy efficiency program data
- 10
Query energy usage
Returns electricity usage aggregated by customer segment (residential, commercial, industrial, agricultural). Use this to analyze energy consumption patterns in specific geographic areas over time. ZIP code format: 5-digit (e.g., "94102"). Dates in YYYY-MM-DD format. Query PG&E energy consumption data by ZIP code and date range
Observed, not estimated
905ms average. Fast in production.
PG&E Data Portals is checked daily against the live service.
- Fastest day
- 756ms
- Slowest day
- 1064ms
- 14-day trend
- Slowing+25%
Connect your client
One URL. Every client.
Activate the Connector, copy your link, and paste it into the client you already use. 10 capabilities arrive ready to run.
Preview access · not provider authentication
The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of PG&E Data Portals, so you can see the experience inside your AI.
It does not authenticate your account with PG&E Data Portals. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.
PG&E Data Portals Connector
You're all set. Choose your MCP client and follow the setup instructions.
https://edge.vinkius.com/vk_preview_koKqgz30wiNhUEvNw5dr4TMuBeyBg7bpLhFFQZsI/mcpClaude Desktop
Follow the steps below to connect in seconds.
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — PG&E Data Portals capabilities are ready to use.
{
"mcpServers": {
"pge-data-portals-mcp": {
"url": "https://edge.vinkius.com/vk_preview_koKqgz30wiNhUEvNw5dr4TMuBeyBg7bpLhFFQZsI/mcp"
}
}
}- Claude
- ChatGPT
- Cursor
- VS Code
- Windsurf
- Claude Code
- JetBrains
- Cline
Step-by-step instructions for each client are in the guide. How to connect
FAQ
Questions PG&E Data Portals owners ask.
- 01
What types of datasets are available?
PG&E Data Portals offers: energy usage (electricity and gas by ZIP code), EV adoption (vehicle registrations), solar generation (capacity and production), energy efficiency programs (participation and savings), and grid infrastructure (distribution circuits, substations). Use search_datasets to discover all available datasets.
- 02
Is authentication required?
No, the PG&E Data Portals API is publicly accessible without authentication. An API key is optional and only needed if you want higher rate limits for production use. Most queries work out of the box without any credentials.
- 03
Can I filter data by specific ZIP codes and date ranges?
Yes! Most capabilities support zip_code, start_date, and end_date parameters. For example, query_energy_usage accepts ZIP code and date range to return electricity consumption for that specific area and period. Use query_by_date_range for any dataset with custom date filtering.