能源数据API服务器

Prospector Energy MCP Server

MCP (Model Context Protocol) server that gives AI agents access to the Prospector Labs Energy Data API — US interconnection queue projects with milestone tracking, distributed generation installations, developer profiles and track records, ITC/PTC tax credit calculations, and ITC deal sourcing.

Counts change daily and are not published here. For current coverage call get_queue_stats, get_dg_stats and get_developer_stats, or see https://api.prospectorlabs.io/catalog.

Quick start

Add this to your MCP client. The package ships with the production API as its default base URL, so no environment variables are required:

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

Try the API in one line first:

curl https://api.prospectorlabs.io/stats

Get a free API key in about 30 seconds, self-serve: https://api.prospectorlabs.io/start

Tools Available (32 tools)

The Tier column is the plan a tool needs, as published at https://api.prospectorlabs.io/plans. It is a capability, not a price. Free covers every tool except bulk export, subject to a per-request row cap and a monthly query allowance.

Projects & Search

Deals & Investment

Tax Credits

Developers

Market Data

Grid Infrastructure

Distributed Generation

Utility

What's New in v0.4.1

• Production API is the default base URL — https://api.prospectorlabs.io. Earlier versions defaulted to the Railway hostname, so no PROSPECTOR_API_URL env var is needed any more.
• Two tools delisted — get_lmp_daily and get_rto_generation were returning empty result sets because the pipelines behind them are not populated. A tool that is listed and always empty is worse than one that is absent; they will return when the data does.
• Tiers describe capability, not price — the tool table now matches the plans published at /plans. See Plans and payments below.

Setup

Claude Desktop

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

Claude Code

Add to your .mcp.json:

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

Cursor

Add to Cursor Settings > MCP Servers:

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

Direct Install

# From PyPI
pip install prospector-energy-mcp

# With payment support
pip install prospector-energy-mcp[payments]

# Or with uv
uvx prospector-energy-mcp

Configuration

Get a key at https://api.prospectorlabs.io/start.

Plans and payments

Plans

Plans are published and enforced by the API, not by this package. Call https://api.prospectorlabs.io/plans for the current list — it is the only authoritative source.

Access and Enterprise are priced per engagement — owen@prospectorlabs.io.

Agent payments (MPP)

This server can additionally charge per tool call in USDC over the Machine Payments Protocol (MPP), for operators who run their own instance.

MPP is opt-in and off by default: with MPP_RECIPIENT_ADDRESS unset, paid_tool returns the tool unwrapped and no payment challenge is ever issued. The public prospector-energy-mcp package charges nothing per call — access is governed by your API key's plan. Per-call amounts, when an operator enables MPP, are configured in src/prospector_energy/payments.py.

When enabled, the flow is:

1. Agent calls a paid tool (e.g., search_projects)
2. Server responds with a payment challenge (HTTP 402 equivalent)
3. Agent pays in USDC on the Tempo blockchain
4. Server verifies payment and returns data
5. Free tools (stats, summaries) always work without payment

AgentCash

This server is also listed on AgentCash.

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 were monthly average LMPs in PJM this year?"
• "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 ".[payments]"

# 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