InfraMap MCP server
Commit Nov 11, 2026Provides AI assistants read-only access to US power market data including plant generation, emissions, ISO node prices, and curtailment metrics.
Also known as inframaporg/mcp, mcp
- Stars
- 0
- Tools
- 59
- Downloads, 30 days
- —
- Latest version
- 0.3.1
- Last commit
- Nov 11, 2026
- License
- MIT
What is InfraMap MCP?
InfraMap provides AI assistants read-only access to US power market data including plant generation, emissions, ISO node prices, and curtailment metrics. It exposes 59 tools, such as query_analyst_store, get_project_profile, get_energy_reference.
Summary generated from the project's README
About InfraMap MCP server
InfraMap provides AI assistants with read-only access to comprehensive US power market data. It is designed for energy analysts and researchers who need to query information regarding operating power plants, including generation, emissions, ownership, and offtake. The server covers seven major ISO and RTO markets, offering detailed metrics such as node prices, hub prices, basis, and ancillary service prices.
Users connect to the remote server via Streamable HTTP using OAuth for authentication. It is compatible with various clients including Claude, ChatGPT, Cursor, and VS Code. Access requires an InfraMap Pro, Team, or Enterprise plan. The server includes 59 specialized tools, such as query_analyst_store for SQL-based inventory screening and get_live_prices for real-time 5-minute market pricing. Every data result includes its specific source, coverage, and time period to ensure transparency in energy modeling and market analysis.
What you can do with it
- 1Analyze plant generation trendsRequest a report on a specific plant's monthly generation for a given year including data sources.
- 2Evaluate renewable energy curtailmentCompare modeled curtailment increases for wind and solar plants between different years.
- 3Estimate wholesale energy revenueCalculate projected energy revenue for a power plant using specific pricing nodes.
- 4Screen power plant inventoriesRun a SQL query to rank or compare different projects across the entire power plant inventory.
Written from the project's README. Every use case is checked against a quote from it.
How to install InfraMap MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall InfraMap MCP in Claude Code
$ claude mcp add --transport http mcp https://mcp.inframap.pro/mcpInstall InfraMap MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.inframap.pro/mcp"
}
}
}Install InfraMap MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.inframap.pro/mcp"
}
}
}Install InfraMap MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.inframap.pro/mcp"}'Install InfraMap MCP in Codex
$ codex mcp add mcp --url https://mcp.inframap.pro/mcpInstall InfraMap MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] url = "https://mcp.inframap.pro/mcp"
Install InfraMap MCP in Gemini CLI
$ gemini mcp add -s user --transport http mcp https://mcp.inframap.pro/mcpInstall InfraMap MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.inframap.pro/mcp",
"type": "http"
}
}
}InfraMap MCP tools 59
Detected from the READMEquery_analyst_storeget_project_profileget_energy_referenceget_data_catalogdiscover_energy_dataget_source_catalogget_analysis_guideexplain_analysis_limitget_data_coveragesearch_energy_projectsget_project_detailsget_project_evidence_bundle
Show all 59 toolsShow fewer tools
resolve_grid_areasget_project_grid_membershipget_project_source_coverageget_grid_topologyget_project_generationget_project_performanceget_project_generation_potentialget_project_emissionsget_project_ownershiprank_generation_changerank_capacity_factorsget_eqr_hourly_salesget_live_pricesget_project_market_pricesget_ercot_project_dataanalyze_market_periodmodel_project_revenuerank_ercot_basisassess_capture_rate_coveragecompare_project_curtailmentinvestigate_project_curtailmentget_project_modeled_curtailmentget_regional_curtailment_historyget_project_battery_operationsanalyze_battery_periodquery_source_recordssummarize_source_recordsrank_source_recordsget_grid_hourlyget_plant_weatherexplain_output_with_weatherget_grid_conditionsget_iso_forecastsexplain_output_or_price_changeget_outagesget_binding_constraintsexplain_node_congestionget_ancillary_pricesget_capacity_auctionsrank_pricing_nodesget_node_battery_revenuesearch_interconnection_queueget_queue_changesget_substationfind_pricing_nodesfind_substations_nearbyget_plant_water_use
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableinframaporg/mcp is public and reachablegithub.com/inframaporg/mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-11github.com/inframaporg/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model59 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubInfraMap MCP server
The InfraMap MCP server gives AI assistants read-only access to InfraMap Pro's US power market data: every operating US power plant with its generation, emissions, ownership and offtake, plus ISO node prices, hub prices and basis in seven markets, ancillary service prices, binding constraints, capacity auctions, interconnection queues, outages and forecasts. It has 59 tools, and every result carries its sources, period and coverage.
- Server URL:
https://mcp.inframap.pro/mcp(Streamable HTTP) - Sign-in: OAuth. Your client opens the InfraMap sign-in page the first time it connects.
- Account: a free InfraMap Pro account. InfraMap Pro is in open beta: every account can connect while the beta runs, and usage limits apply. See what the beta includes.
- Listed in: Claude's connectors directory
- Setup for 18 clients: mcp.inframap.pro and the docs
The server is hosted by InfraMap. This repository holds its documentation, client configuration, registry entry and a Claude Code plugin; the server's source code is not published here.
What you can ask
- Show Barry's reported monthly generation for 2024, including any missing months and the source for each value.
- How many plants in each ISO have a reviewed market price node, and how many have none?
- Which wind and solar plants had the largest increase in modeled curtailment from 2024 to 2025? Show both the credit and no-credit bounds.
- Estimate Moccasin's wholesale energy revenue for January through June 2025 and say which price node you used.
- Which coal plants reported the most cooling water withdrawal, and what is the water stress at each site?
More in examples/prompts.md.
Connect
Claude (web, desktop and mobile)
Open InfraMap in the connectors directory and choose Connect. Claude opens the InfraMap sign-in page.
If the directory isn't available to you, go to Customize, Connectors, choose Add custom connector, name it InfraMap and paste https://mcp.inframap.pro/mcp.
Claude Code
claude mcp add --transport http --scope user inframap https://mcp.inframap.pro/mcp
Then run /mcp in Claude Code, pick inframap and choose Authenticate. To install the server together with the InfraMap research skill, use the plugin in this repository:
/plugin marketplace add inframaporg/mcp
/plugin install inframap@inframap
ChatGPT
Go to chatgpt.com/plugins, choose +, then Add custom MCP server. Name it InfraMap, paste https://mcp.inframap.pro/mcp, set Authentication to OAuth and choose Create as a plugin. In a chat, type @ and pick InfraMap.
Codex
codex mcp add inframap --url https://mcp.inframap.pro/mcp
codex mcp login inframap
Cursor
Add to ~/.cursor/mcp.json (everywhere) or .cursor/mcp.json (one project):
{
"mcpServers": {
"inframap": {
"url": "https://mcp.inframap.pro/mcp"
}
}
}
Cursor then shows a sign-in prompt for inframap under Customize, MCPs.
VS Code
code --add-mcp '{"name":"inframap","type":"http","url":"https://mcp.inframap.pro/mcp"}'
Or add .vscode/mcp.json to a project:
{
"servers": {
"inframap": {
"type": "http",
"url": "https://mcp.inframap.pro/mcp"
}
}
}
Gemini CLI
gemini mcp add --transport http --scope user inframap https://mcp.inframap.pro/mcp
Any other client
Most clients accept a remote server as a name and a URL. Use Streamable HTTP; the server has no SSE endpoint. For clients that only start local servers, the open-source mcp-remote bridge forwards to InfraMap and handles sign-in:
{
"mcpServers": {
"inframap": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.inframap.pro/mcp"
]
}
}
}
Config files for each client are in examples/.
Tools
All 59 tools are read-only. Start with get_data_catalog to see what each dataset covers and how current it is.
Analyst store
Whole-inventory screens in SQL, one-call project dossiers and reviewed definitions.
| Tool | What it does |
|---|---|
query_analyst_store |
Query the analyst store (SQL). Run one read-only SQLite SELECT over the analyst store to screen, rank, count or compare projects across the whole inventory. Returns up to 200 rows with the store version and table citations. |
get_project_profile |
Get project profile. Dossier for up to 5 projects: identity, capacity, region, pricing node and hub, earlier nodes from price chains, recent generation and capacity factor, ownership, offtake and 2024–2025 price and basis. |
get_energy_reference |
Look up energy definitions. Reviewed definitions, formulas, guards and primary references for energy terms and study topics such as capacity factor, basis, capture rate, ELCC and curtailment. |
Discovery and definitions
What data exists, how current it is, and which tool reads it.
| Tool | What it does |
|---|---|
get_data_catalog |
Inspect the data catalog. Every approved data source with its as-of date, coverage, tools and limits. Call it first. |
discover_energy_data |
Find datasets. Search datasets by research terms, or inspect one dataset ID for meaning, grain, join rules and coverage. |
get_source_catalog |
List loaded source datasets. Loaded source tables (water, boiler fuel, utilities, gas operators, EQR contracts, modeled renewable profiles) with grain, fields and caveats. |
get_analysis_guide |
Get analysis guide. Reviewed terminology, formulas, study checklists and primary references for study design. |
explain_analysis_limit |
Explain an analysis limit. Explains a known gap, the inputs it would need and the closest supported alternative. |
get_data_coverage |
Get data coverage. What InfraMap holds now for each market dataset, ISO and product: first and latest day, missing days, the longest gap, last write and backfill progress, with source, licence and units. |
Projects and regions
Find plants, resolve grid areas and read source-level project evidence.
| Tool | What it does |
|---|---|
search_energy_projects |
Search power plants. Filter, rank and page the current operating EIA catalog by state, fuel, ISO, balancing authority, county, size and hybrid status. Hybrid components are grouped once. |
get_project_details |
Get generator and plant details. Generator and plant fields for exact EIA plant IDs, with generator paging. |
get_project_evidence_bundle |
Get project evidence bundle. Compact verified evidence and yearly summaries for up to 5 projects and 60 months, by section. |
resolve_grid_areas |
Resolve grid areas. Resolve an ISO, RTO or balancing-authority code, name or alias before filtering plants. |
get_project_grid_membership |
Get project grid membership. Dated unit-level balancing-authority relationships for one project, including reviewed transitions. |
get_project_source_coverage |
Get project source coverage. Which source datasets hold records for a project, with the native IDs to query them. |
get_grid_topology |
Get grid network coverage. Public OpenStreetMap network coverage and per-project USGS and OSM geometry counts. |
Generation, emissions, ownership
Reported output, performance, potential, emissions and ownership.
| Tool | What it does |
|---|---|
get_project_generation |
Get project generation. EIA-923 monthly net MWh, with battery charging and discharging kept separate. |
get_project_performance |
Get project performance. Complete-period generation, dated nameplate capacity factor, battery flows and utilization for up to 5 projects. |
get_project_generation_potential |
Compare generation with modeled potential. Actual generation beside reviewed physical potential and retrospective expected generation. |
get_project_emissions |
Get project emissions. Annual EPA CO₂, SO₂ and NOx mass for monitored units, linked through the PUDL CAMD–EIA crosswalk. US short tons. |
get_project_ownership |
Get project ownership. Dated ownership and offtake conclusions and reported generator relationships. |
rank_generation_change |
Rank generation change. Rank reported net generation change between the same months of two years across the filtered fleet. |
rank_capacity_factors |
Rank wind capacity factors. Pick the largest wind projects by operating wind nameplate, then rank their capacity factors. |
Markets
Live 5-minute prices, node and hub prices, basis, period analysis and modeled revenue in seven ISOs and RTOs.
| Tool | What it does |
|---|---|
get_eqr_hourly_sales |
Get FERC EQR hourly sales. Seller-reported hourly sales by delivery point for about 430 plants in 2026 Q2. Reported sales, not metered generation. |
get_live_prices |
Get live 5-minute prices. The newest 5-minute real-time prices at every hub and zone, or at every pricing node ranked highest or lowest (view nodes, Pro), or up to 8 days at one hub or 2 days at a plant's pricing node, or hourly real-time and day-ahead prices for up to 62 days from the archive, with congestion and loss components and day-ahead against real-time. Updated every 5 minutes in all seven markets. |
get_project_market_prices |
Get project market prices. Node coverage or one month of price statistics for a plant outside ERCOT (CAISO, ISO-NE, MISO, NYISO, PJM, SPP). |
get_ercot_project_data |
Get ERCOT project data. ERCOT resource net energy (SMNE), node and hub settlement point prices and basis for one month. |
analyze_market_period |
Analyze a market period. Prices, basis and coverage for up to 5 projects over up to 12 months in any of the seven markets. |
model_project_revenue |
Model project energy revenue. Historical modeled energy revenue: monthly EIA net generation times the same month’s mean node price. |
rank_ercot_basis |
Rank ERCOT basis. Rank reviewed ERCOT projects by node minus hub price for one month, hub and market. |
assess_capture_rate_coverage |
Check capture rate coverage. Checks whether exact capture rates can be computed for a project, and what is missing. |
Curtailment
The experimental modeled curtailment range, and operator-published regional history.
| Tool | What it does |
|---|---|
compare_project_curtailment |
Compare modeled curtailment. Screen or compare modeled curtailment across the full eligible cohort between matched month windows, nationally or by ISO, state or technology. |
investigate_project_curtailment |
Investigate modeled curtailment. Hour-level investigation for up to 5 plants over at most 366 days: loss blocks, durations, price coincidence and seasonality. |
get_project_modeled_curtailment |
Get modeled curtailment. Monthly modeled curtailed MWh, expected curtailed hours and physical potential for one plant and year. |
get_regional_curtailment_history |
Get operator curtailment history. Operator-published regional curtailment: CAISO 2015–2025 and SPP 2024–2025. |
ERCOT batteries
Reviewed ERCOT battery operations before and after RTC+B.
| Tool | What it does |
|---|---|
get_project_battery_operations |
Get ERCOT battery operations. Battery resource coverage or one month of operational energy. |
analyze_battery_period |
Analyze ERCOT battery operations. Battery operations over up to 24 months for up to 5 plants, with the two metering regimes kept apart. |
Source records
Row-level reads, calculations and rankings over loaded source tables.
| Tool | What it does |
|---|---|
query_source_records |
Query source records. Find exact entity IDs, then read compact records with units and citations. |
summarize_source_records |
Summarize source records. Totals and heat rates across every matching record for 1–5 entities and at most 60 months. |
rank_source_records |
Rank source records. Rank all records at the dataset’s own grain before taking the top rows. |
Grid and weather
Hourly load, fuel mix and carbon intensity by balancing authority, and point weather at every wind and solar plant.
| Tool | What it does |
|---|---|
get_grid_hourly |
Get hourly load, fuel mix and carbon. EIA-930 demand, forecast, net generation, interchange, generation by fuel and hourly CO₂ intensity for up to 4 ISOs or balancing authorities, up to 92 days, updated hourly. |
get_plant_weather |
Get plant weather. Hourly hub-height wind, irradiance and temperature at a wind or solar plant from 2010, for windows up to 31 days. |
explain_output_with_weather |
Check output against weather. Monthly capacity factor against what the plant's own weather predicts, with months below 60% of expected flagged, for up to 5 plants, or every wind or solar plant in a filter ranked by output against its weather (mode rank). A model estimate. |
get_grid_conditions |
Get ISO grid conditions. Each ISO's own 5-minute or hourly load, fuel mix by category, storage and reported curtailment (SPP, CAISO) for up to 14 days, with hourly rows for short windows. |
get_iso_forecasts |
Get ISO forecasts. An ISO's load, wind or solar forecast from its stored vintages as it stood at the day-ahead deadline, latest or a chosen time, with the publish time used and the error against actual. |
explain_output_or_price_change |
Explain a change in output or price. Why a plant's output or a node's price changed over a window: the change against a baseline, then outages, curtailment, binding constraints and congestion, negative prices, weather, forecast error and queue context, each labeled observed, calculated, modeled or hypothesis, with the evidence that is missing. |
get_outages |
Get outages. Generation capability on outage by ISO, category and zone with how far ahead it was reported, or individual outage reports with every unit or facility ranked by time and MW out: CAISO and ERCOT units, NYISO and ISO-NE transmission. Up to a year. |
Constraints, reserves and capacity
Binding transmission constraints with shadow prices, ancillary service prices, capacity auction results and modeled battery revenue.
| Tool | What it does |
|---|---|
get_binding_constraints |
Get binding constraints. Constraints that bound in an ISO, day-ahead or real-time, with hours bound and shadow prices, ranked; windows over 31 days (up to four years) rank every constraint from daily totals. |
explain_node_congestion |
Explain a node's congestion. Which constraints drove a pricing node's congestion, month by month, from shift factors estimated on 90 days of prices. A statistical estimate. |
get_ancillary_prices |
Get ancillary service prices. Regulation, spinning, non-spinning, supplemental, ramp and other reserve prices by service and zone, day-ahead or real-time, for up to a year day-ahead or 92 days real-time, grouped by service class, with monthly means for long windows. |
get_capacity_auctions |
Get capacity auction results. PJM, MISO, NYISO and ISO-NE capacity auction clearing prices by zone and delivery period, in the native unit and $/MW-day, with cleared MW and sources. |
rank_pricing_nodes |
Rank every pricing node. Every pricing node of one ISO or all seven, ranked in one call by modeled battery revenue, estimated congestion or observed price statistics (mean real-time and day-ahead price, DA-RT spread, negative and spike hours, volatility), with how many nodes were ranked and the plants at each node. |
get_node_battery_revenue |
Get modeled battery revenue. What a 1, 2 or 4-hour battery could have earned at a pricing node by month: day-ahead, real-time perfect foresight and day-ahead with reserves. A model estimate. |
Queues and substations
Every ISO's interconnection queue as daily snapshots, and a substation catalog with the sources behind each field.
| Tool | What it does |
|---|---|
search_interconnection_queue |
Search interconnection queues. Queued projects across all seven ISOs by state, county, fuel, status, size, name or point of interconnection, with totals by fuel. |
get_queue_changes |
Get queue changes. Projects that entered, withdrew or changed status, size, date or point of interconnection over up to 92 days. |
get_substation |
Get substation. A substation's voltage, operator and location with the sources behind each field, and the plants, queue projects and pricing nodes that connect there; or the substation a project connects to. |
find_pricing_nodes |
Find pricing nodes. Where pricing nodes are: a node, a project's nodes, the nodes at a substation, a text search or nodes near a point, with type, zone, kV, ISO station, position and confidence, substation, plants and which price products hold them. |
find_substations_nearby |
Find nearby substations. Substations within a radius of a project or a point, nearest first, optionally above a voltage. |
Water
Plant cooling water and the water stress of each plant’s watershed.
| Tool | What it does |
|---|---|
get_plant_water_use |
Get plant cooling water and water stress. EIA cooling water withdrawal and consumption by plant, joined to the USGS surface water stress index at the plant location, for about 730 plants. |
Data
Counts as of November 2, 2026. The live figures, periods and caveats for every dataset are on the data sources page, and the first year served in each market is on the coverage page.
- Power plants: 14,233 operating plants and batteries, grouped into 14,225 projects with 1,391 GW of nameplate capacity, from EIA-860M (August 2026).
- Generation: monthly net generation from EIA-923, January 2000 to July 2026.
- Emissions and water: EPA emissions from 1995 to 2025, cooling water use and water stress.
- Prices: hourly day-ahead and real-time node prices, hub prices and basis at 3,466 plant pricing nodes in CAISO, ERCOT, ISO-NE, MISO, NYISO, PJM and SPP, plus live five-minute real-time hub prices for all seven.
- Load and fuel mix: hourly EIA-930 demand, forecast, interchange and generation by fuel for every balancing authority, from July 2015, and each ISO's own load, fuel mix and storage every 5 minutes.
- Ancillary services: day-ahead and real-time reserve and regulation prices and cleared MW in all seven markets.
- Binding constraints: day-ahead and real-time shadow prices with a constraint registry, in all seven markets.
- Capacity auctions: PJM, MISO, NYISO and ISO-NE results by zone, in native units and $/MW-day.
- Interconnection queues: daily snapshots of all seven ISO queues with a per-project change log.
- Forecasts and outages: ISO load, wind and solar forecasts with every published vintage kept, and generation outage events or outage MW by type.
- Substations: a catalog of about 80,000 US substations from OpenStreetMap (ODbL), ISO and public sources, with a crosswalk to pricing nodes, plants and queue points.
- Ownership and offtake: a confirmed ultimate owner for 2,081 projects, and a named contract buyer for 1,422 projects from FERC PPA records and reviewed contracts, 473 buyers in all (as of September 26, 2026).
- Modeled data: physical potential, expected generation and modeled curtailment, plus modeled battery revenue per node and estimated shift factors, always labeled as models.
How results are reported:
- Observed, calculated and modeled values stay separate and are labeled.
- Missing is not zero: a null means the source has no usable record. Zero and negative values are shown as reported.
- Each dataset keeps its own period, and every result states it.
- A pricing node, hub or balancing area linked to a plant is an association, not proof of settlement, a contract or a physical connection.
The methodology page explains how plants are grouped and how capacity factor, potential, curtailment, prices and basis are calculated.
Limits
- About 120 requests a minute and 2 at a time per account, with a daily cap of 1,000 tool calls, of which 200 may be
query_analyst_storequeries. The daily counts reset at 00:00 UTC. Prefer onequery_analyst_storequery over many single-plant calls. query_analyst_storeruns one read-only SQLiteSELECTover a documented schema and returns up to 200 rows.- US data only. The server does not give investment advice, residential retail rates or customer account data.
Security and privacy
- Security and vulnerability reports. See also SECURITY.md.
- Privacy policy, which covers MCP request logs and OAuth tokens
- Terms of service and acceptable use
- Subprocessors
Support
Email contact@inframap.org, or open an issue in this repository for documentation and setup problems.
About
InfraMap Pro is a US power market data platform for energy analysts, developers, asset managers, offtakers and traders, with a web map, an AI analyst and this MCP server. InfraMap Edu (edu.inframap.org) is a separate, free app for learning how the grid works and does not include Pro's data or this server. InfraMap Pro is not affiliated with Open Infrastructure Map, Cycloid's InfraMap tool for Terraform diagrams, InfraMap Corp. or iWater's infraMAP.
License
The documentation and configuration files in this repository are released under the MIT License. Use of the InfraMap service and its data is governed by the Terms of service.
InfraMap MCP questions
How do I add InfraMap MCP to Claude Code?
Run claude mcp add --transport http mcp https://mcp.inframap.pro/mcp in your terminal. Add --scope user to make it available in every project.
How do I add InfraMap MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does InfraMap MCP provide?
It exposes 59 tools, including query_analyst_store, get_project_profile, get_energy_reference, get_data_catalog, discover_energy_data.
What kind of data does InfraMap provide?
It provides US power market data including operating power plants, generation, emissions, ownership, ISO node prices, hub prices, basis, and curtailment.
How do I authenticate with the InfraMap MCP server?
The server uses OAuth for sign-in. Your client will open the InfraMap sign-in page the first time it connects.
Is the data provided by the server read-only?
Yes, all 59 tools provided by the server are read-only.
Does every result include its source?
Yes, every result returned by the server includes its sources, the period covered, and the coverage details.