PatchOps

Available tools

7 tools

Tool	Description
`getSeries`	Single series by seriesId. Pass startYear/endYear; with BLS_API_KEY, set calculations=true for net + percent change.
`getMultipleSeries`	Up to 25 series unkeyed (50 keyed) in one POST. Validates tier caps before sending.
`findIndustrialSeries`	Curated NAICS↔seriesId lookup. Pass naicsCode (e.g. '211' or '213111') or keyword ('drilling', 'refining', 'pipeline').
`listSurveys`	All 73 BLS surveys, abbreviation, name, hasAnnualAverages, allowsNetChange.
`getSurvey`	Survey-specific metadata for one abbreviation (e.g. 'CE', 'EN' QCEW, 'WP' PPI commodity).
`getPopularSeries`	Top recently-requested series for a given survey, useful for cold-start UX.
`getServiceInfo`	Curated NAICS coverage, tier limits (no-key 25/day vs key 500/day), period code reference (M01-M13), error-detection guidance.

About

U.S. Bureau of Labor Statistics public data source: Current Employment Statistics (CES national plus SM state/metro), Quarterly Census of Employment and Wages (QCEW), Producer Price Index (PPI industry PCU plus commodity WPU), Consumer Price Index, Local Area Unemployment Statistics, Occupational Employment and Wage Statistics, Job Openings and Labor Turnover, productivity, employment cost index, and import/export prices, 73 surveys total. The anonymous tier permits 25 requests/day, up to 25 series, up to a 10-year span. Setting BLS_API_KEY raises caps to 500/day, up to 50 series, up to a 20-year span, and adds calculations (net and percent change) and series catalog metadata. Ships with a curated NAICS-to-seriesId map covering 50+ industrial slices (Mining 21, Oil & Gas Extraction 211, Drilling 213111, Support Activities 213112, Petroleum Refineries 32411, Pipeline Transportation 4861/4862, Utilities 22, Construction 23, Manufacturing 31-33), because programmatic series-id construction drifts from the BLS docs. No setup needed.

Requirements

Toggle on
Toggle on and use, no setup needed.
Optional API key (BYOK)
Optionally connect your own free BLS registration key to raise caps to 500/day and bill the requests to your own key. Field: apiKey (BLS_API_KEY).

Setup

A few steps to connect your AI agents to BLS Labor Stats.

Get started

1
Toggle Connector On
Open /mcp and enable BLS Labor Stats with the toggle, no credentials needed for the 25-req/day tier.
2
Start Querying
Call findIndustrialSeries with naicsCode: '211' to discover Oil & Gas Extraction seriesIds. Then getSeries with one of the returned seriesIds for a 10-year history. Or getMultipleSeries with 3-5 ids in one call to compare drilling vs refining vs pipelines.
3
Optional: Raise Tier Limits
Register at https://data.bls.gov/registrationEngine/ for a free access key and set BLS_API_KEY in your Vercel environment to raise to 500 calls/day, 50 series per call, 20-year span, and unlock calculations + catalog.

Connect to your AI assistant

Pick the tool your team uses for the exact setup steps.

1
Open Claude settings
Launch Claude, click the profile button (bottom left), and go to Settings.
2
Access connectors
Open the Connectors tab, scroll to the bottom, and click “Add custom connector”.
3
Name your connector
Enter any name you’d like for this connector.
4
Get the connector URL
Log in to PatchOps, open the /mcp page, and copy the connector URL you want to use.
5
Add the connector
Paste the URL into the “Remote MCP server URL” box and click Add.
6
Start using
Your BLS Labor Stats connector is ready to use in Claude.