mcp server
bls-labor-mcp-server
Fetch US Bureau of Labor Statistics data — CPI, unemployment, wages, JOLTS, and more via MCP.
Description as published by the maintainer. Source
- version 0.4.11
- active
active — Most recent push to the repository was 2026-07-17.
What this server can do
6 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.
bls_dataframe_describe(name)- List canvas dataframes materialized by bls_get_series, with provenance (source tool, query parameters), TTL, row count, and column schema. Use before writing SQL to confirm column names. Lazy-sweeps expired tables before responding. Requires CANVAS_PROVIDER_TYPE=duckdb.
bls_dataframe_query(sql, preview, row_limit, register_as)- Run a single-statement SELECT against the canvas dataframes registered by bls_get_series. Read-only: writes, DDL, DROP, COPY, PRAGMA, ATTACH, and external-file table functions are rejected. System catalogs (information_schema, pg_catalog, sqlite_master, duckdb_*) are denied at the bridge layer — use bls_dataframe_describe to list available dataframes. Supports JOINs, aggregates, window functions, and CTEs. Optional register_as persists the result as a new dataframe with a fresh TTL for chained analysis. Canvas SQL operations consume zero BLS API quota. Requires CANVAS_PROVIDER_TYPE=duckdb. Required: sql.
bls_get_latest(series_ids)- Return the single most recent observation for one or more BLS series. Use for "what is X right now" questions — the current unemployment rate, the latest CPI reading, etc. Each series consumes one API query against the 500/day limit; for the current value of many series, bls_get_series with a 1-year window is more quota-efficient (one query for up to 50 series). Recommended limit: 10 series; maximum: 50. Required: series_ids.
bls_get_series(end_year, series_ids, start_year, calculations, annual_average)- Fetch time-series data for 1–50 BLS series by SeriesID in a single API request (one query against the 500/day limit). Supports optional year range (up to 20 years per request) and BLS-computed period-over-period calculations (net change and percent change; a survey returns whichever it supports and silently omits the rest — CPI and PPI return percent change only, the inflation rate). Observations cover real periods only and are safe to sum or average as returned; set annual_average to add each year's annual-average row, which is that year's mean rather than an additional period. When the total observation count would exceed the inline context budget, results spill to a canvas dataframe and the response includes a dataset.name handle for follow-up SQL via bls_dataframe_query. Use bls_search_series first if you need to resolve a concept to a SeriesID. Required: series_ids.
bls_list_surveys(category)- List BLS survey programs with their abbreviation codes, full names, and metadata about calculation support and annual averages. Use to discover which survey covers a topic before calling bls_search_series. Optional category filter narrows results to prices, employment, wages, productivity, injuries, or time_use surveys.
bls_search_series(area, limit, query, survey, seasonal_adjustment)- Search the BLS series catalog by natural language query, survey code, geographic area, or keywords to resolve cryptic SeriesIDs. Returns matching series with decoded components (survey, area, item, seasonal flag) and plain-language names. Use this before bls_get_series when you have a concept but not a SeriesID. Operates offline — no API quota consumed. Survey filter accepts two-letter codes (CU, CE, LN, LA, PC, JT, OE, EC, PR). Area filter accepts state names, MSA names, or FIPS area codes. Required: query.
Last successful function declaration observed on . Source: https://bls-labor.caseyjhand.com/mcp. We list what the server declared; we do not call any of these functions.
Endpoint status observed on . Source: https://bls-labor.caseyjhand.com/mcp.
Signals
These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.
| Signal | Value | What it measures | Window | Observed | Source |
|---|---|---|---|---|---|
| GitHub stars | 1 | Number of GitHub accounts that bookmarked this repository since it was created. It is a bookmark count, not installs, not active users and not quality. | cumulative, all time | GitHub | |
| Last commit | 2026-07-17 | Date of the most recent push to any branch. This is the strongest cheap indicator of whether the project is still maintained. | point in time | GitHub | |
| Open issues | 11 | Open issues plus open pull requests, as GitHub counts them together. A high number can mean an active project or an abandoned one. | as of fetch | GitHub | |
| Latest published version | 0.4.11 | Latest version string the maintainer published to the registry. | as of fetch | Model Context Protocol | |
| Registry record last updated | 2026-07-17 | When the registry record was last updated by its maintainer. | point in time | Model Context Protocol | |
| First listed in the MCP Registry | 2026-07-17 | Date this server was first published to the official MCP Registry. Not a usage or quality measure. | point in time | Model Context Protocol | |
| repository status | active | The repository exists on GitHub and is not archived. This says nothing about how recently it was worked on. | as of fetch | GitHub | |
| mcp tools declared | 6 tools | Number of functions the server itself declared when asked to list them. This is what the server offers an agent, not a measure of how well any of them work. | as of probe | bls-labor.caseyjhand.com | |
| mcp endpoint status | ok | The server listed 6 functions when asked. | as of probe | bls-labor.caseyjhand.com |
Where to get it
Related, by what their authors tagged them
-
io.github.cyanheads/bls-mcp-server
— last commit 2026-07-17, shares bls, bun, bureau-of-labor-statistics
Fetch US Bureau of Labor Statistics data — CPI, unemployment, wages, JOLTS, and more via MCP.
-
io.github.cyanheads/federal-reserve-mcp-server
— last commit 2026-07-30, shares bun, cyanheads, economics
Search and fetch ~800K Federal Reserve economic time-series from the FRED API via MCP.
-
io.github.cyanheads/fred-mcp-server
— last commit 2026-07-30, shares bun, cyanheads, economics
Search and fetch ~800K Federal Reserve economic time-series from the FRED API via MCP.
-
fipeX MCP
— last commit 2026-08-01, shares time-series
Brazilian FIPE vehicle reference prices: search, current price, history and comparison. Keyless.
-
ArcadeDB MCP Server
— last commit 2026-08-06, shares time-series
Built-in MCP server for ArcadeDB multi-model database (graph, document, vector, time-series)
-
ArcadeDB
— last commit 2026-08-06, shares time-series
Multi-Model database with built-in MCP server for SQL, Cypher, Gremlin, and GraphQL.
-
io.github.doazvjettu/leakguard-mcp
— last commit 2026-06-13, shares time-series
Static analyzer flagging lookahead bias & data leakage in ML/trading code before backtest.
-
io.github.cyanheads/worldbank-mcp-server
— last commit 2026-07-30, shares bun, cyanheads, economics
Query 29,500+ World Bank development indicators for 200+ countries across 60+ years.
-
io.github.cyanheads/imf-mcp-server
— last commit 2026-08-06, shares cyanheads, economics
Query IMF SDMX 3.0 macroeconomic dataflows — WEO, BOP, CPI, exchange rates, 190 countries.
-
io.github.cyanheads/oecd-mcp-server
— last commit 2026-07-30, shares cyanheads, economics
Search and query 1,500+ OECD statistical datasets via SDMX. Keyless.
These share tags the maintainers applied themselves, such as bls, bun, bureau-of-labor-statistics, cpi. Common tags like "mcp" or "ai" are ignored for this: agreeing with six hundred other projects is not a similarity.
This is not a recommendation and not a test result. It is a map of what the authors said their work is about.
Also from cyanheads
-
io.github.cyanheads/anime-mcp-server
— last commit 2026-07-30
Search anime/manga, franchise watch order, schedule, characters, rankings, studio filmography.
-
io.github.cyanheads/arxiv-mcp-server
— last commit 2026-07-27
Search arXiv, fetch paper metadata, and read full-text content.
-
io.github.cyanheads/astronomy-mcp-server
— last commit 2026-07-31
Offline observational astronomy: positions, rise/set, moon phases, eclipses, and seasons.
-
io.github.cyanheads/attack-surface-mcp-server
— last commit 2026-07-30
Passive external attack-surface mapping: CT subdomains, DNS, TLS, HTTP posture, RDAP/WHOIS, Shodan.
-
io.github.cyanheads/aviation-weather-mcp-server
— last commit 2026-07-30
Fetch METARs, TAFs, PIREPs, and SIGMETs/AIRMETs from the NWS Aviation Weather Center.
-
io.github.cyanheads/biorxiv-mcp-server
— last commit 2026-07-11
Search and retrieve bioRxiv and medRxiv preprints — by DOI, date interval, or keyword — via MCP.
-
io.github.cyanheads/bluesky-mcp-server
— last commit 2026-07-31
Search posts, profiles, feeds, threads, and trending topics on Bluesky.
-
io.github.cyanheads/brapi-mcp-server
— last commit 2026-07-16
Collaborative BrAPI v2.1 MCP workspace — studies, germplasm, genotypes across Breedbase, T3, more.
-
io.github.cyanheads/calculator-mcp-server
— last commit 2026-07-02
Evaluate, simplify, and differentiate mathematical expressions.
-
io.github.cyanheads/cdc-health-mcp-server
— last commit 2026-07-11
Search and query CDC public health data — mortality, vaccinations, surveillance, behavioral risk.
How the author describes it
Topics the maintainer set on GitHub: bls, bun, bureau-of-labor-statistics, cpi, cyanheads, economics, jolts, labor-market, mcp, mcp-server, model-context-protocol, ppi, time-series, typescript, unemployment, wages.
This record as data
Every field on this page, with its source and observation date, is in the catalog JSON. Fetch the whole kind at once instead of parsing this HTML.
GET /api/v1/entries/mcp_server.json