eqr_contracts_search
Pack: ferc-eqr · Endpoint: https://gateway.pipeworx.io/ferc-eqr/mcp
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/eqr_contracts_search for the schema, then POST the same URL with its arguments for the data.
Search FERC EQR wholesale power contracts by seller, counterparty and/or product. Returns contract-level records: seller, customer, product (e.g. ENERGY, CAPACITY), quantity, rate, rate units, delivery/receipt points, and the contract execution/term dates. Each row is one RATE-PERIOD line item within a contract (a single contract can have several rows for different rate periods) — not a settled trade. Use eqr_seller_lookup first to resolve a company name to a company_id_ferc if you want an exact-seller match rather than a name substring. Sourced from FERC EQR via PUDL (CC-BY-4.0), Phase 1 (contract terms; no transaction-level price/volume yet).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
seller | string | no | Seller name (substring match) or exact company_id_ferc. |
counterparty | string | no | Counterparty/customer company name, substring match. |
product | string | no | Product name substring, e.g. “ENERGY”, “CAPACITY”, “TRANSMISSION”. |
quarter_from | string | no | Earliest quarter to include, format “2020q1”. |
quarter_to | string | no | Latest quarter to include, format “2026q2”. |
limit | number | no | Max rows to return (default 20, max 100). |
offset | number | no | Row offset for paging beyond limit (default 0). |
Example call
Arguments
{
"seller": "C000740"
}
curl
curl -X POST https://gateway.pipeworx.io/ferc-eqr/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"eqr_contracts_search","arguments":{"seller":"C000740"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('eqr_contracts_search', {
"seller": "C000740"
});
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"ferc-eqr": {
"url": "https://gateway.pipeworx.io/ferc-eqr/mcp"
}
}
}
See Getting Started for client-specific install steps.