`msha_mine_search`

Pack: msha-mines · 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/msha_mine_search for the schema, then POST the same URL with its arguments for the data.

Search MSHA (Mine Safety and Health Administration) mine records by operator name, controller name, or mine name. Returns matching mines with their MSHA Mine ID, status (Active, Abandoned, Intermittent, etc.), mine type (Surface/Underground/Facility), coal vs metal/non-metal classification, commodity, state, and current operator/controller. Use this to find the Mine ID(s) for a company before calling msha_mine_detail. Sourced from MSHA’s own bulk mine-records file (public domain), refreshed weekly. Keyless.

Parameters

Name	Type	Required	Description
`query`	string	yes	Operator, controller, or mine name (or part of one) to search for, e.g. “Peabody”, “Warrior Met Coal”, “O’Neal Quarry”.
`state`	string	no	Optional 2-letter US state code to restrict the search, e.g. “WV”, “KY”.
`status`	string	no	Optional exact mine status filter: Active, Abandoned, “Abandoned and Sealed”, Intermittent, “New Mine”, NonProducing, “Temporarily Idled”.
`limit`	number	no	Max mines to return (default 25, max 100).

Example call

Arguments

{
  "query": "Peabody"
}

curl

curl -X POST https://gateway.pipeworx.io/msha-mines/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"msha_mine_search","arguments":{"query":"Peabody"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('msha_mine_search', {
  "query": "Peabody"
});

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 msha-mines pack

{
  "mcpServers": {
    "msha-mines": {
      "url": "https://gateway.pipeworx.io/msha-mines/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

msha_mine_search