# MCP tools

Reference for every tool, resource and prompt the Load Factor MCP server offers.

The Load Factor MCP server offers 35 tools, grouped below by what they answer. Your assistant chooses among them, so you rarely need a tool's name; this reference shows what each one does, its parameters and an example request. Every tool only reads data.

Your assistant sees only the tools your plan includes; see [Access & permissions](https://loadfactorenergy.com/developers/mcp/access-and-permissions#which-tools-your-modules-unlock). Every tool returns compact JSON with a one-line summary, caveats and a link to each record in the Load Factor app.

## Evidence sources and strength

Every evidence record names its source exactly as the Load Factor web app's evidence panel does, never as an internal code. The same three fields appear in every tool that returns evidence, in REST responses to API-key requests, and in the project workbook and Orange Button exports.

| Field | What it holds |
|---|---|
| `source` | The source as the web app names it, for example "Interconnection agreement", "ISO queue (official)", "FERC EQR contract", "SEC subsidiary list (Ex-21)" or "Industry news". |
| `source_family` | The kind of public record: grid-operator filings, federal regulatory filings, corporate disclosures, state and local public records, plant and market data, news and announcements, or other public records. Analyst review notes read "Analyst review". |
| `strength` | How much weight the record carries, in the web app's words: **Strong** (an official record that names the company directly), **Supporting** (a public record that points to the company; a second independent source is needed to confirm) or **Lead** (a weaker signal, never enough on its own). |

Summaries count records `by_source` (keyed by `source`) and `by_family`. To narrow [`get_project_evidence`](https://loadfactorenergy.com/developers/tools/get_project_evidence), pass `source` (a value from `by_source`), `family` (a family name, or a distinctive word such as "federal") or `min_strength` (`strong`, `supporting`, `lead` or `any`). The older `source_type` and `max_tier` filters are still accepted for existing clients but are deprecated.

## Search & fetch

- [`search`](https://loadfactorenergy.com/developers/tools/search): Search everything in Load Factor by free text.
- [`fetch`](https://loadfactorenergy.com/developers/tools/fetch): Fetch the full record for an id returned by `search`.

## Queue projects

- [`search_projects`](https://loadfactorenergy.com/developers/tools/search_projects): Find renewable interconnection-queue projects and who is developing them.
- [`get_project`](https://loadfactorenergy.com/developers/tools/get_project): Full dossier for one renewable queue project: who is developing it, how sure Load Factor is, and why.
- [`get_project_evidence`](https://loadfactorenergy.com/developers/tools/get_project_evidence): List the active evidence rows behind one queue project's developer identification, from grid-operator queues, federal filings, corporate disclosures, state and…
- [`queue_stats`](https://loadfactorenergy.com/developers/tools/queue_stats): Counts and capacity of renewable queue projects grouped by one dimension, optionally pivoted by a second one.

## Companies

- [`find_companies`](https://loadfactorenergy.com/developers/tools/find_companies): Resolve a company name to the exact name variants Load Factor holds.
- [`get_company_profile`](https://loadfactorenergy.com/developers/tools/get_company_profile): One company's footprint across Load Factor for the exact name variants you pass (usually chosen from find_companies; case- and accent-insensitive exact match).
- [`get_company_queue_rollup`](https://loadfactorenergy.com/developers/tools/get_company_queue_rollup): One-call queue rollup for up to 10 companies.

## SEC company intelligence

- [`sec_search_companies`](https://loadfactorenergy.com/developers/tools/sec_search_companies): Find SEC EDGAR registrants that Load Factor has linked to a Load Factor company.
- [`sec_company_filings`](https://loadfactorenergy.com/developers/tools/sec_company_filings): Filing timeline of one SEC registrant.
- [`sec_company_subsidiaries`](https://loadfactorenergy.com/developers/tools/sec_company_subsidiaries): One SEC registrant's latest subsidiary list as filed with the SEC.

## Power plants

- [`search_plants`](https://loadfactorenergy.com/developers/tools/search_plants): Search EIA power plants (EIA-860/923: built and planned generating plants, not the interconnection queue).
- [`get_plant`](https://loadfactorenergy.com/developers/tools/get_plant): Dossier for one EIA power plant, by EIA plant id (from search_plants, a /plant/<id> link, or a `search` id such as plant:57695).

## PPAs & offtake

- [`ppa_price_benchmarks`](https://loadfactorenergy.com/developers/tools/ppa_price_benchmarks): Realized PPA prices for one market from FERC Electric Quarterly Report settlements, computed live.
- [`ppa_counterparties`](https://loadfactorenergy.com/developers/tools/ppa_counterparties): Who buys a seller's power, or who sells to a buyer, from FERC EQR filings.
- [`get_ferc_seller_summary`](https://loadfactorenergy.com/developers/tools/get_ferc_seller_summary): One FERC wholesale seller, summarized.
- [`ppa_top_buyers`](https://loadfactorenergy.com/developers/tools/ppa_top_buyers): Largest PPA offtakers in a market, ranked by MWh bought from sellers of the chosen sector, computed live from FERC Electric Quarterly Report settlements.
- [`ppa_expiring_contracts`](https://loadfactorenergy.com/developers/tools/ppa_expiring_contracts): Energy and capacity contracts reported in FERC EQR whose end date falls in a window (default: the next 24 months), with months to expiry computed at query time.

## Deals & news

- [`search_deals_news`](https://loadfactorenergy.com/developers/tools/search_deals_news): Search deal flow and project news, newest first.

## Load Factor Insights

- [`search_insights`](https://loadfactorenergy.com/developers/tools/search_insights): Search Load Factor Insights.

## Grid & markets

- [`grid_context`](https://loadfactorenergy.com/developers/tools/grid_context): Grid infrastructure and market context around one queue project or a latitude/longitude point.
- [`lmp_snapshot`](https://loadfactorenergy.com/developers/tools/lmp_snapshot): Locational marginal price (LMP) snapshot for one ISO market from Load Factor's latest price pull.
- [`transmission_projects`](https://loadfactorenergy.com/developers/tools/transmission_projects): MISO Long-Range Transmission Plan projects.
- [`market_fundamentals`](https://loadfactorenergy.com/developers/tools/market_fundamentals): State and market fundamentals for offtake and siting screens.

## Siting, incentives & permits

- [`search_incentives`](https://loadfactorenergy.com/developers/tools/search_incentives): Find US clean-energy incentive and policy programs.
- [`get_incentive_program`](https://loadfactorenergy.com/developers/tools/get_incentive_program): Full terms of one DSIRE incentive or policy program, by the numeric id returned by search_incentives.
- [`search_permits`](https://loadfactorenergy.com/developers/tools/search_permits): Search state siting and regulatory dockets filed for renewable projects.
- [`search_dg_projects`](https://loadfactorenergy.com/developers/tools/search_dg_projects): Search New York distributed-generation interconnection applications from the NY DPS utility queues.

## Load (data centers)

- [`search_data_centers`](https://loadfactorenergy.com/developers/tools/search_data_centers): Search Load Factor Demand.
- [`get_data_center`](https://loadfactorenergy.com/developers/tools/get_data_center): One data-center site from Load Factor Demand.
- [`get_data_center_supply_screen`](https://loadfactorenergy.com/developers/tools/get_data_center_supply_screen): One data-center site's supply screen.

## Construction & advancing

- [`construction_triggers`](https://loadfactorenergy.com/developers/tools/construction_triggers): Queue projects, EIA plants and data centers that advanced toward construction.

## Catalog & account

- [`whoami`](https://loadfactorenergy.com/developers/tools/whoami): Show the signed-in user's Load Factor access as this connector enforces it.
- [`data_catalog`](https://loadfactorenergy.com/developers/tools/data_catalog): Describe the datasets behind Load Factor's tools.

## Resources

Read-only documents a client can open or attach to a conversation, where it supports MCP resources. They follow your permissions like the tools do.

| URI | Name | What it holds |
|---|---|---|
| `loadfactor://about` | About Load Factor | What Load Factor is, your live coverage (queue counts in your ISOs), the developer confidence model, and how to use the tools available to you. |
| `loadfactor://glossary` | Load Factor glossary | Vocabulary with live counts in your ISOs: developer_confidence values, labels and ranking; which confirmed_* class rows count where two sources agree and which are labelled otherwise; queue statuses grouped as in queue / operating / dead (live = in queue + operating); evidence sources (as the web app names them), source families and strength words; coordinate_confidence values; ISOs with FERC EQR BA codes and LMP coverage; fuels. |
| `loadfactor://project/{project_number}` | Project dossier | One renewable queue project's dossier as markdown (developer, SPV, confidence, evidence summary, caveats), following your permissions. Use the exact queue ID from search_projects; URL-encode spaces or slashes. |

## Prompts

Ready-made prompt templates a client can offer you, where it supports MCP prompts. Each one tells the assistant which tools to use and how to structure the answer.

| Prompt | What it does | Arguments |
|---|---|---|
| `project_diligence_brief` | Diligence brief on one queue project: developer and SPV with confidence and evidence, offtake and price context, permits, news, risks. | `project_number` |
| `developer_portfolio_review` | Review a developer's queue pipeline, operating fleet, offtakers and deals, with name variants and confidence made explicit. | `company` |
| `market_entry_scan` | Scan one ISO for one technology: pipeline size, competitors, PPA and nodal prices, transmission, incentives and entry considerations. | `iso`, `fuel` |
| `ppa_pricing_brief` | Brief on realized PPA prices in one market and sector from FERC EQR: levels, trend, buyers, contract expiries, and nodal price comparison. | `market`, `sector` |
| `competitive_landscape` | Who is developing and operating one technology in one state: developer ranking by pipeline MW with confidence, incumbents, recent deals, unattributed pipeline. | `state`, `fuel` |
