DOL WHD MCP
TypeScript MCP server for accessing Department of Labor enforcement data, OSHA inspections, and SAM.gov contract opportunities via natural language queries.
Ask AI about DOL WHD MCP
Powered by Claude Β· Grounded in docs
I know everything about DOL WHD MCP. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
DOL WHD MCP
TypeScript MCP server for Department of Labor WHD Enforcement, OFLC LCA disclosure, OSHA inspection, and SAM.gov contract opportunity data.
Setup
npm install
npm run build
Create a local .env file:
DOL_API_KEY=your-api-key
SAM_GOV_API_KEY=your-sam-gov-api-key
GOOGLE_PLACES_API_KEY=your-google-places-api-key
The server also accepts DOL_API_KEY, SAM_GOV_API_KEY, or SAM_API_KEY from the process environment. SAM.gov tools can run in dry-run mode without a SAM key. Tool responses redact request URLs and never return keys.
Run Locally Over Stdio
npm start
Example MCP client config:
{
"mcpServers": {
"dol-whd": {
"command": "node",
"args": ["dist/server.js"],
"cwd": "<project-directory>"
}
}
}
Run Remotely Over HTTP
Build first, then start the Streamable HTTP MCP endpoint:
npm run build
npm run start:http
Defaults:
- MCP endpoint:
http://127.0.0.1:8787/mcp - Health check:
http://127.0.0.1:8787/health - Transport: MCP Streamable HTTP, stateless per request.
Remote environment knobs:
DOL_MCP_HOST=127.0.0.1
DOL_MCP_PORT=8787
DOL_MCP_AUTH_TOKEN=change-this-before-exposing
DOL_MCP_ALLOW_ORIGIN=*
If DOL_MCP_AUTH_TOKEN is set, MCP clients must send either:
Authorization: Bearer change-this-before-exposing
or:
X-API-Key: change-this-before-exposing
Keep the default host for local-only access. To make it reachable from another machine, bind to a reachable interface such as 0.0.0.0 and put it behind a trusted tunnel or reverse proxy with authentication. The DOL and SAM.gov API keys remain server-side in .env.
Deploy To Render
The repo ships a render.yaml Blueprint that provisions a free Node web service.
-
From the Render dashboard, click New β Blueprint and point it at
https://github.com/UHQ-Actual/DOL_MCP. -
Render reads
render.yaml, creates thedol-whd-mcpservice, generates a freshDOL_MCP_AUTH_TOKEN, and prompts for the API key secrets (DOL_API_KEY,SAM_API_KEY,GOOGLE_PLACES_API_KEY). -
After the first deploy the public URL is
https://dol-whd-mcp.onrender.com(or whatever Render assigns). Verify with:curl https://<your-service>.onrender.com/health -
Copy the
DOL_MCP_AUTH_TOKENvalue out of the Render env var panel β you need it for the MCP client.
Connect From Claude (Phone Or Web)
Claude.ai's mobile app shares Custom Connectors with the web UI, so adding the remote MCP once unlocks it on every device tied to that account.
- In Claude.ai, open Settings β Connectors β Add custom connector.
- Use the values from the Render deploy:
- URL:
https://<your-service>.onrender.com/mcp - Auth header:
Authorization: Bearer <DOL_MCP_AUTH_TOKEN>
- URL:
- Save. The connector now lists every tool registered by
createServer()(WHD, OFLC LCA, Foreign Labor, OSHA, SAM.gov, Google Places,ask_government_data). - Toggle the connector on inside any conversation to call the tools from your phone or laptop.
Tools
ask_government_data: Route a plain-English question to the right database and execute the query against WHD enforcement, OSHA inspections, DOL foreign-labor/LCA disclosures, or SAM.gov opportunities.whd_enforcement_query: QueryWHD/enforcementwithlimit,offset,fields,sort,sort_by, andfilter_object.whd_enforcement_case: Look up a numericcase_id.whd_enforcement_metadata: Return full metadata rows, with optionalsearch,category, andlimit.whd_enforcement_fields: Return concise field descriptions for query building.dol_datasets_search: Search the public DOL datasets catalog.lca_disclosure_files: Return official DOL OFLC LCA disclosure and record-layout URLs for a fiscal year quarter.lca_disclosure_fields: Read field names from a DOL LCA disclosure XLSX file.lca_search: Search DOL OFLC LCA disclosure data by employer, worksite, title, SOC, NAICS, status, visa class, wage, and dates.lca_employer_profile: Build a DOL LCA-only employer profile with certification counts, wage statistics, top job titles, SOC codes, worksites, H-1B dependent, and willful violator flags.foreign_labor_files: Discover official DOL OFLC disclosure workbook, record-layout, and auxiliary file URLs forLCA,PERM,H-2A,H-2B, orCW.foreign_labor_fields: Read field names from an official DOL foreign-labor disclosure XLSX file.foreign_labor_search: Stream-search DOL OFLC foreign-labor disclosure workbooks and return a unified schema across LCA, PERM, H-2A, H-2B, and CW-1.osha_fields: Return metadata for the official DOL OSHAinspectionorviolationdataset.osha_inspection_search: Search OSHA inspections by establishment, state, city, NAICS, inspection type, safety/health, and open-date range. Optionally joins non-deleted violation/citation records.osha_inspection_detail: Look up one OSHA inspection byactivity_nrand optionally join violation/citation records.sam_opportunities_search: Search official SAM.gov contract opportunities by title keywords, NAICS codes, procurement types, set-aside code, place-of-performance state, and posted date range.sam_opportunity_detail: Look up one SAM.gov opportunity bynoticeId.sam_reference: Return common SAM.gov procurement type and set-aside codes.places_search: Search Google Places (New) Text Search for businesses in an area. Returns deduped results withgoogleMapsUrlfor source-tracing. Designed as a per-round retrieval primitive for the Restaurant Research Agent.places_detail: Look up one Google place by Place ID. Returns hours, delivery/dine-in flags, and (optionally) editorialSummary and reviews.
LCA tools use official OFLC disclosure workbooks from the DOL Performance Data page. The workbooks can be large, so downloaded files are cached under .cache/dol-lca/. You can also pass localFile with an already-downloaded official LCA disclosure XLSX file.
The LCA profile is DOL-only. USCIS H-1B petition approval and denial rates are not included unless a separate USCIS data source is added.
Foreign-labor tools read the DOL Performance Data page to discover current disclosure links, then stream-parse XLSX files row by row. Supported programs are LCA, PERM, H-2A, H-2B, and CW; supported unified-parser fiscal years are 2020 through 2030. Use localFile to point at an already-downloaded official workbook.
OSHA tools use the official DOL Open Data API datasets OSHA/inspection and OSHA/violation. Violation rows are joined to inspections by activity_nr; rows with delete_flag equal to X are excluded from joined output.
SAM.gov tools use the official Opportunities API at https://api.sam.gov/opportunities/v2/search. Live searches require SAM_GOV_API_KEY or SAM_API_KEY; dry-run searches return sample opportunities without calling SAM.gov. The API requires posted date bounds, so postedDaysAgo is converted to postedFrom and postedTo in MM/dd/yyyy format.
Examples
Filter Iowa records with back wages:
{
"limit": 10,
"fields": ["case_id", "trade_nm", "st_cd", "bw_atp_amt", "findings_end_date"],
"sort": "desc",
"sort_by": "bw_atp_amt",
"filter_object": {
"and": [
{ "field": "st_cd", "operator": "eq", "value": "IA" },
{ "field": "bw_atp_amt", "operator": "gt", "value": 0 }
]
}
}
Search field metadata:
{
"search": "backwage",
"limit": 20
}
Search LCA disclosure data:
{
"fiscalYear": 2026,
"quarter": 1,
"employerName": "Google",
"state": "CA",
"jobTitle": "software",
"maxResults": 25
}
Build a DOL LCA employer profile:
{
"fiscalYear": 2026,
"quarter": 1,
"employerName": "Google",
"searchMode": "contains",
"maxResults": 5000
}
Search unified DOL foreign-labor disclosures:
{
"visaProgram": "H-2A",
"fiscalYear": 2026,
"fiscalQuarter": "Q1",
"worksiteState": "IA",
"caseStatus": "Certified",
"maxItems": 100
}
Search PERM certifications:
{
"visaProgram": "PERM",
"fiscalYear": 2026,
"fiscalQuarter": "Q1",
"employerName": "Intel",
"minAnnualWage": 150000,
"maxItems": 500
}
Search OSHA inspections with joined citations:
{
"companyName": "Walmart",
"state": "TX",
"includeViolations": true,
"maxResults": 25
}
Search fatality/catastrophe construction inspections:
{
"state": "TX",
"naicsCode": "23",
"inspectionType": "A",
"dateFrom": "2024-01-01",
"includeViolations": true,
"maxResults": 100
}
Search SAM.gov opportunities in dry-run mode:
{
"keywords": "cybersecurity",
"naicsCodes": ["541512"],
"setAsideType": "SBA",
"postedDaysAgo": 30,
"maxResults": 10,
"dryRun": true
}
Search live SAM.gov opportunities after adding a SAM key:
{
"keywords": "software development",
"naicsCodes": ["541512", "541511"],
"procurementTypes": ["o", "k", "r"],
"state": "VA",
"postedDaysAgo": 30,
"maxResults": 100,
"dryRun": false
}
Ask a plain-English routed question:
{
"question": "Show OSHA inspections and citations for Walmart in TX",
"maxResults": 10
}
Ask for SAM.gov opportunities in dry-run mode:
{
"question": "Find cybersecurity solicitations NAICS 541512 in Virginia",
"maxResults": 10,
"dryRun": true
}
Ask for DOL foreign-labor disclosure records:
{
"question": "H-2A certified farm jobs in IA SOC 45-2092 over $20 hourly",
"maxResults": 10
}
Search Google Places for restaurants in a city:
{
"query": "restaurants in Hillsdale, MI",
"includedTypes": ["restaurant"],
"maxResults": 30,
"excludeClosed": true
}
Look up one Google place by Place ID:
{
"placeId": "ChIJN1t_tDeuEmsRUsoyG83frY4",
"includeAtmosphere": false
}
