Route a plain-English question to the right source: WHD enforcement, OSHA inspections, DOL foreign-labor/LCA disclosures, or SAM.gov contract opportunities.

Query concluded Wage and Hour Division compliance actions from the DOL WHD Enforcement (WHISARD) dataset. IMPORTANT date semantics: findings_end_date is the date violations STOPPED occurring, NOT the date the case was concluded. Investigation lag from end-of-violation to case-closed is typically 6-24 months. When filtering for 'cases from 2024-2025,' use a wider findings_end_date window (e.g., findings_end_date >= 2022-10-01) and rank by recency; a strict 2024-2025 findings filter will return an artificially small slice. The ld_dt field is the dataset load date, not the case-conclusion date.

Look up WHD Enforcement records by numeric case_id.

Return metadata rows for the WHD Enforcement (WHISARD) dataset, optionally filtered by text.

Return concise WHD Enforcement field names, labels, descriptions, categories, data types, and units.

Search the public DOL v4 datasets catalog. This endpoint does not require the API key.

Return official DOL OFLC LCA disclosure, Appendix A, worksite, and record-layout URLs for a fiscal year quarter.

Read field names from a DOL LCA disclosure XLSX file.

Search official DOL OFLC LCA disclosure XLSX data by employer, worksite, job title, SOC, NAICS, status, visa class, wage, and dates.

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.

Discover official DOL OFLC disclosure workbook, record-layout, and auxiliary file URLs for LCA, PERM, H-2A, H-2B, or CW.

Read field names from an official DOL foreign-labor disclosure XLSX file.

Stream-search and normalize DOL OFLC disclosure XLSX records across LCA, PERM, H-2A, H-2B, and CW programs. ROUTE BY VISA PROGRAM: H-2A is AGRICULTURAL seasonal labor (farms, ranches, NAICS 11) — never use H-2B for farms. H-2B is NON-AGRICULTURAL seasonal labor (landscaping, hospitality, construction, seafood processing) — never use H-2A here. LCA covers H-1B / H-1B1 / E-3 specialty occupations (tech, healthcare, engineering, academics) and is wrong for ag or seasonal labor. PERM is permanent labor certification (green-card sponsorship). CW is CNMI-only. DO NOT call this tool for general restaurant or business research — restaurants almost never sponsor visa workers; use places_search instead. The first call for a given (visaProgram, fiscalYear, fiscalQuarter) downloads the official disclosure workbook and builds a gzipped JSONL cache (slow, can take 30-90s for big LCA quarters); subsequent calls hit the cache in 1-3 seconds. To avoid first-call timeouts, narrow with maxItems and one or more of employerName, worksiteState, socCode, or caseStatus.

Return metadata fields for the official DOL OSHA inspection or violation dataset.

Search official DOL OSHA inspection records and optionally join non-deleted violation/citation records by activity_nr.

Look up one OSHA inspection by activity number and optionally join violation/citation records.

Static reference: returns the URL and agency for the Secretary of State (or DFI / Corporation Commission, depending on the state) business-entity search portal for a given US state. Use this when the user wants to verify an entity manually, file a records request, or use a state's own search form. Includes bulk-download availability and pricing where published. The 10 Midwest states are verified with detailed notes; the other 40 states are encoded with general portal URLs that should be sanity-checked before enforcement use. For programmatic lookups, prefer business_entity_search via OpenCorporates.

Static reference: returns the OSHA jurisdiction tier (federal_osha / public_only_state_plan / complete_state_plan), program name (MIOSHA, Cal/OSHA, IOSHA, etc.), administering agency, expected reporting lag in days for state-plan submissions to federal OIS, public-records request path, and a one-line caveat the agent can paste alongside osha_inspection_search results. Use this when an agent's OSHA query in MI / MN / IA / IN / CA / WA returns sparse recent data — the lookup tells the agent (and the user) why and how to get fresher data.

Search the official SAM.gov Opportunities API by title keywords, NAICS codes, procurement type, set-aside, contracting office state, and posted date range. Place-of-performance state and city filters are applied client-side because SAM.gov's v2 API does not support them server-side. Note: SAM.gov returns SOLICITATIONS (announcements), not awarded contracts; awardAmount is null on most rows. For awarded federal contracts with dollar amounts, use USAspending.gov instead.

Look up one SAM.gov opportunity by notice ID. Live mode requires a SAM.gov API key in the environment.

Return common SAM.gov procurement type and set-aside codes used by the opportunity search tool.

Search USAspending.gov for federal contract and assistance awards with KNOWN obligated dollar amounts. Use this when the user asks 'how much was contract X for' or 'all federal contracts in Y over $Z' — SAM.gov returns solicitations not awards. No API key required. Filters by NAICS, PSC, recipient, awarding agency, place-of-performance state/city/county FIPS, award amount range, and start-date range. Defaults to contract award types (A, B, C, D) for the past 12 months.

Search Google Places (New) Text Search for businesses in an area. Designed as a per-round retrieval primitive for the Restaurant Research Agent. Returns deduplicated results with googleMapsUrl for source-tracing. Auto-pages up to maxResults (Google caps at ~60 per query). Defaults to includedTypes=['restaurant'] and excludeClosed=true.

Look up one Google place by Place ID. Returns hours, delivery/dine-in flags, and other detail fields. Set includeAtmosphere=true to also fetch editorialSummary and reviews (higher pricing tier).

Look up a US city/town/CDP via the Census geocoder, then fetch its total population from the ACS 5-year estimate. Returns: total population, area tier (major_metro / mid_metro / small_or_rural matching the adv_estimate multiplier table), row-scaling tier and target (matching the Restaurant Research Agent's row-scaling formula max(pop/250, floor)), county FIPS for usaspending_award_search, state FIPS, place FIPS, and the high-cost-of-living-state flag for CA/NY/MA/WA/HI. Use this BEFORE adv_estimate when sizing an enforcement universe or running a restaurant research workflow against an unfamiliar city. Free Census API; no key required for basic queries.

Search Secretary of State / DFI business registrations via OpenCorporates (sourced directly from official state registries; data lineage is auditable). Use to map a trade name to its legal entity, identify the registered agent for service of process, find related entities under common ownership, or confirm an establishment is an active legal entity. Free tier is ~50 lookups/day with attribution; higher volume requires an OPENCORPORATES_API_KEY env var. For US states, pass the two-letter state code (MI, IL, etc.) as jurisdictionCode and it auto-prefixes to OpenCorporates' us_xx format. Returns name, company number, status, type, incorporation date, registered address, previous names, and an opencorporates_url for source-tracing.

Look up one entity by jurisdiction + state company number via OpenCorporates. Use after business_entity_search to get the full canonical record (full address, previous names, branch info, dissolution date, registry URL). Free with attribution.

Deterministic ADV screening calculator for FLSA enterprise-coverage triage. Encodes Methods 1-4 (per-employee, capacity-derived, chain per-unit, format default), the geographic multiplier, ±40% range math, and the $500,000 FLSA flag (Above / Below / Borderline / Insufficient Data). NOT a coverage determination — screening signal only. Method selection priority: chain per-unit ADV > employee count > capacity input > format default. Method 2 capacity input priority (highest first): seatCount > occupantLoad (×0.85 → seats) > squareFootage (BOH subtract + IBC 15-sqft-per-occupant + ×0.85) > parkingSpaces (× format-typical seats-per-space). Always pass capacitySource so the audit trail records where the number came from. Best practice: read employeeCount from osha_inspection_search results and pass it in here when an OSHA inspection record exists for the establishment (employee_count is a required OSHA field). Returns separate columns for estimate, range, method, capacity_input, capacity_source, flsa_flag, confidence, and a derivation-chain notes string.