frac_wells
Pack: fracfocus · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/frac_wells for the schema, then POST the same URL with its arguments for the data.
Search FracFocus well-level frac job disclosures by state/county/operator.
Tool description as the model sees it
Hydraulic fracturing job disclosures (wells) from FracFocus, the national frac-chemical disclosure registry — filter by state, county, and/or operator name (operator matches as a substring, case-insensitive). Returns each well’s API number, operator, well name, location, job dates, and base fluid volumes, newest job first. Covers FracFocus’s full disclosure history (back to its earliest submissions, most of it from 2011 on). Pass the API number from a result into frac_chemicals to get that job’s chemical ingredient list. At least one of state, county, or operator is required — an unscoped scan of ~250k disclosures is not supported.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
state | string | yes | US state name, e.g. “Texas” (full name, case-insensitive; FracFocus stores state as a name, not a postal code). |
county | string | no | County name, e.g. “Martin”. Case-insensitive exact match. |
operator | string | no | Operator name, substring match, case-insensitive, e.g. “Pioneer”. |
limit | number | no | Max rows, 1-200. Default 50. A truncated response carries truncated:true, total_matching, and a hint for narrowing. |
offset | number | no | Pagination offset. Default 0. |
Example call
Arguments
{
"state": "Texas",
"county": "Martin",
"limit": 5
}
curl
curl -X POST https://gateway.pipeworx.io/fracfocus/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"frac_wells","arguments":{"state":"Texas","county":"Martin","limit":5}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('frac_wells', {
"state": "Texas",
"county": "Martin",
"limit": 5
});
Connect
Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:
{
"mcpServers": {
"pipeworx": {
"url": "https://pipeworx.io/mcp"
}
}
}
Connect to just the fracfocus pack
{
"mcpServers": {
"fracfocus": {
"url": "https://gateway.pipeworx.io/fracfocus/mcp"
}
}
}
See Getting Started for client-specific install steps.