frac_chemicals
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_chemicals for the schema, then POST the same URL with its arguments for the data.
Chemical ingredients disclosed for one well by API number.
Tool description as the model sees it
Chemical ingredient list disclosed for one well, by API number (the American Petroleum Institute well identifier, e.g. “42-317-37262-00-00” or “4231737262” — dashes optional). Returns, per disclosed job on that well: trade name, supplier, purpose (e.g. “Surfactant”, “Biocide”, “Proppant”), CAS number, ingredient name, percent of the hydraulic fracturing job by mass, and mass in pounds; trade-secret ingredients carry no CAS number and the claimant company instead. Ingredient-level detail is only loaded for jobs on or after this pack’s coverage cutoff (see data_as_of/ingredients_since in the response) — a well found in frac_wells but outside that window returns found:false with reason “outside_ingredients_coverage”, distinct from reason “unknown_api_number” when the well itself does not exist in FracFocus at all.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
api_number | string | yes | API well number, with or without dashes, e.g. “42-317-37262-00-00” or “4231737262”. |
limit | number | no | Max ingredient rows, 1-500. Default 100. |
offset | number | no | Pagination offset. Default 0. |
Example call
Arguments
{
"api_number": "42317448410000"
}
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_chemicals","arguments":{"api_number":"42317448410000"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('frac_chemicals', {
"api_number": "42317448410000"
});
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.