Skip to main content

MCP server for Prospector Labs Energy Data API — interconnection queues, tax credits, developer intelligence, and deal sourcing

Project description

Prospector Energy MCP Server

MCP (Model Context Protocol) server that gives AI agents access to the Prospector Labs Energy Data API — 47,000+ interconnection queue projects, 5.4M distributed generation installations, 6,593 developer profiles, tax credit calculations, and ITC deal sourcing.

Tools Available (31 tools)

Projects & Search

Tool Description
search_projects Search 47K+ utility-scale energy projects by state, ISO, type, developer, capacity
get_project Full project detail with all enrichment fields
get_project_score Investability score breakdown for a project
get_queue_stats Aggregate interconnection queue statistics
export_projects Export projects as CSV (up to 50K)

Deals & Investment

Tool Description
find_itc_deals ITC-eligible investment opportunities with scoring
get_itc_deal Detailed ITC deal profile
get_itc_summary Aggregate ITC deal pipeline statistics
get_investable_projects Pre-screened investable projects with grades
get_investable_summary Aggregate investability statistics
get_deal_sheet Formatted 1-page deal sheet (HTML, print to PDF)

Tax Credits

Tool Description
calculate_tax_credits ITC/PTC eligibility with all IRA bonus adders
check_domestic_content Domestic content ITC bonus eligibility (+10%)

Developers

Tool Description
search_developers Search 6,593 developer profiles by name
get_developer Full developer profile with track record
get_developer_projects All projects by a specific developer
get_developer_stats Developer aggregate statistics

Market Data

Tool Description
get_lmp_daily Daily locational marginal prices
get_lmp_monthly Monthly average LMP trends
get_lmp_zones List available LMP pricing zones
get_capacity_prices Capacity market auction prices
get_fuel_prices Fuel prices by state and type
get_technology_costs NREL ATB cost projections
get_rto_generation RTO-level generation by fuel type

Grid Infrastructure

Tool Description
get_grid_turbines 75K+ US wind turbines (USWTDB)
get_grid_transmission 95K+ transmission lines (HIFLD)
get_grid_substations 64K+ electrical substations (HIFLD)
get_generators EIA generator inventory (26K+ generators)

Distributed Generation

Tool Description
search_dg_projects Search 5.4M distributed generation installations
get_dg_stats DG aggregate statistics

Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "prospector-energy": {
      "command": "uvx",
      "args": ["prospector-energy-mcp"]
    }
  }
}

Or if installed locally:

{
  "mcpServers": {
    "prospector-energy": {
      "command": "/path/to/venv/bin/python",
      "args": ["-m", "prospector_energy"]
    }
  }
}

Claude Code

Add to your Claude Code settings or .mcp.json:

{
  "mcpServers": {
    "prospector-energy": {
      "command": "uvx",
      "args": ["prospector-energy-mcp"]
    }
  }
}

Cursor

Add to Cursor's MCP settings (Settings > MCP Servers):

{
  "prospector-energy": {
    "command": "uvx",
    "args": ["prospector-energy-mcp"]
  }
}

Direct Install

# From GitHub
pip install git+https://github.com/OwenCoonahan/prospector-energy-mcp.git

# From PyPI
pip install prospector-energy-mcp

# Or with uv
uvx prospector-energy-mcp

# Run directly
prospector-energy-mcp

Configuration

Environment Variable Description Default
PROSPECTOR_API_URL API base URL https://prospector-platform-production.up.railway.app
PROSPECTOR_API_KEY API key for authenticated access None (free tier)

Example Queries

Once connected, ask your AI agent:

  • "How many solar projects are in the ERCOT queue?"
  • "Calculate tax credits for a 2MW solar project in West Virginia"
  • "Find investable ITC deals in New Jersey with credit rates above 50%"
  • "Tell me about developer NextEra Energy's track record"
  • "What's the average LMP in PJM this week?"
  • "Find battery storage projects over 100MW in California"

Development

# Clone and install in dev mode
cd mcp-server
python3.12 -m venv .venv
source .venv/bin/activate
pip install -e .

# Run with stdio transport (default)
python -m prospector_energy

# Run with SSE transport
python -m prospector_energy --sse

# Test with MCP inspector
npx @modelcontextprotocol/inspector python -m prospector_energy

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

prospector_energy_mcp-0.3.0.tar.gz (9.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

prospector_energy_mcp-0.3.0-py3-none-any.whl (10.3 kB view details)

Uploaded Python 3

File details

Details for the file prospector_energy_mcp-0.3.0.tar.gz.

File metadata

  • Download URL: prospector_energy_mcp-0.3.0.tar.gz
  • Upload date:
  • Size: 9.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for prospector_energy_mcp-0.3.0.tar.gz
Algorithm Hash digest
SHA256 a6cfc3872e037e66672d433f27fef95be96be4b5f1af99f3835240b40607fa15
MD5 39b359e2609b64aba7bf0f5e94f270e3
BLAKE2b-256 3f49081d5e92b1caae74b1be344b5ba8257e61f1ff9e3b8c9ff270b2a2f0b957

See more details on using hashes here.

File details

Details for the file prospector_energy_mcp-0.3.0-py3-none-any.whl.

File metadata

File hashes

Hashes for prospector_energy_mcp-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8087357b62324b7c58a8e8255cbb0267fc23212e207f39a62f4906b80f96620f
MD5 4e6e701b254b328ca048a2541e8a245b
BLAKE2b-256 8545b69fd4b311e694fd36452261cd34ad173ae281eed354e7a8808490900d99

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page