{"data":{"name":"io.github.cyanheads/bls-labor-mcp-server","title":null,"description":"Fetch US Bureau of Labor Statistics data — CPI, unemployment, wages, JOLTS, and more via MCP.","version":"0.6.0","websiteUrl":null,"repositoryUrl":"https://github.com/cyanheads/bls-labor-mcp-server","remotes":[{"url":"https://bls-labor.caseyjhand.com/mcp","type":"streamable-http"}],"packages":[{"version":"0.6.0","identifier":"@cyanheads/bls-labor-mcp-server","runtimeHint":"stdio","registryType":"npm","runtimeArguments":null,"environmentVariables":null},{"version":"0.6.0","identifier":"@cyanheads/bls-labor-mcp-server","runtimeHint":"streamable-http","registryType":"npm","runtimeArguments":null,"environmentVariables":null}],"status":"active","isLatest":true,"publishedAt":"2026-10-19T02:06:19.315Z","updatedAt":"2026-10-19T02:06:19.315Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"stars":null,"title":null,"source":"official-registry","sourceId":"io.github.cyanheads/bls-labor-mcp-server","updatedAt":"2026-10-19T02:06:19.315Z","confidence":100,"websiteUrl":null,"description":"Fetch US Bureau of Labor Statistics data — CPI, unemployment, wages, JOLTS, and more via MCP.","verification":"official","repositoryUrl":"https://github.com/cyanheads/bls-labor-mcp-server"}],"toolIndex":{"tools":[{"serverName":"io.github.cyanheads/bls-labor-mcp-server","endpointFingerprint":"266efc011453a9d386324b579434164ffe0bfe193b5cd845143633de768a0184","name":"bls_dataframe_describe","title":"Describe BLS Dataframes","description":"List canvas dataframes materialized by bls_get_series or by bls_dataframe_query register_as, with provenance (source tool, query parameters), TTL, row count, and column schema. Use before writing SQL to confirm column names and types. Lazy-sweeps expired tables before responding.","inputSchema":{"type":"object","properties":{"name":{"description":"Optional dataframe name to describe a single dataframe — a df_XXXXX_XXXXX name from bls_get_series, or a register_as name from bls_dataframe_query. Omit, or leave blank, to list all active dataframes.","type":"string"}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true,"openWorldHint":false},"definitionHash":"2ae55571e7b44198b689e049a0b6e2ac3c6857e07861291b52de7626524774ce","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:19.378Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/bls-labor-mcp-server","endpointFingerprint":"266efc011453a9d386324b579434164ffe0bfe193b5cd845143633de768a0184","name":"bls_dataframe_query","title":"Query BLS Dataframes","description":"Run a single-statement SELECT against the canvas dataframes registered by bls_get_series or by an earlier register_as. Read-only: writes, DDL, DROP, COPY, PRAGMA, ATTACH, and external-file table functions are rejected. System catalogs and DuckDB metadata views (information_schema, pg_catalog, sqlite_master, and views and functions such as pg_tables and duckdb_tables) are denied at the bridge layer wherever a statement names one, as an alias, CTE, or column name included, and as a register_as name — 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.","inputSchema":{"type":"object","properties":{"sql":{"type":"string","minLength":1,"description":"Single-statement SELECT against df_<id> tables on the shared canvas. Reference dataframes by the names returned in bls_get_series responses or listed by bls_dataframe_describe. Standard DuckDB SQL — joins, aggregates, window functions, CTEs all supported. Example: SELECT series_id, year, period, value FROM df_AAAAA_BBBBB WHERE year >= '2020' ORDER BY year DESC."},"register_as":{"description":"When set, persist the query result as a new dataframe under this name. Fresh TTL — not inherited from parent tables. Use to chain analyses without re-running source SQL or consuming additional BLS quota.","type":"string"},"preview":{"description":"Inline row preview count, clamped to the applied row_limit (at most 10000) with notice. Defaults to row_limit. Set lower (e.g. 50) when chaining via register_as and only a sample is needed immediately.","type":"integer","minimum":0,"maximum":9007199254740991},"row_limit":{"default":1000,"description":"Response row limit (default 1000); requests above 10000 are clamped with notice. Full results live on-canvas under register_as when provided.","type":"integer","minimum":1,"maximum":9007199254740991}},"required":["sql"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true,"openWorldHint":false},"definitionHash":"654b1585b70e89941a1aa05ce1de309cb0e86cd4d7bcb7b7e6e22a450abb26d3","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:19.378Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/bls-labor-mcp-server","endpointFingerprint":"266efc011453a9d386324b579434164ffe0bfe193b5cd845143633de768a0184","name":"bls_get_latest","title":"Get Latest BLS Observation","description":"Return the single most recent observation for BLS series. SeriesIDs are trimmed, uppercased, and deduplicated in first-occurrence order. Processes the first 50 unique IDs and returns the exact remainder as unprocessedSeriesIds for a separate request. Each processed series costs one API query; bls_get_series with a 1-year window uses one query for a batch. Recommended limit: 10 series.","inputSchema":{"type":"object","properties":{"series_ids":{"minItems":1,"type":"array","items":{"type":"string","minLength":1},"description":"BLS SeriesIDs, trimmed, uppercased, and deduplicated in first-occurrence order. Processes the first 50 unique IDs; unprocessedSeriesIds names the exact remainder. Each processed ID consumes one daily API query. Recommended: ≤10 series."}},"required":["series_ids"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true,"openWorldHint":true},"definitionHash":"e3d39295d539131bbe1a9022056e635bcb7390f4bb6e1c06c6cf319c80ef2af2","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:19.378Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/bls-labor-mcp-server","endpointFingerprint":"266efc011453a9d386324b579434164ffe0bfe193b5cd845143633de768a0184","name":"bls_get_series","title":"Get BLS Time-Series Data","description":"Fetch BLS time-series data in a single API request (one query). SeriesIDs are trimmed, uppercased, and deduplicated in first-occurrence order. Processes up to 25 unique IDs without a key or 50 with one; unprocessedSeriesIds names the exact remainder for a separate request. Supports optional year range (up to 20 years; BLS may reduce it) and BLS-computed net/percent changes when available. BLS can publish a '-' missing-value sentinel; check observation.available before arithmetic. Set annual_average to add BLS-computed annual summary rows, which are not additional periods or universally arithmetic means. Large results spill to a dataframe when canvas is configured; otherwise all observations return inline. Use dataset.name in bls_dataframe_describe, then bls_dataframe_query SQL. Use bls_search_series to resolve concepts to SeriesIDs.","inputSchema":{"type":"object","properties":{"series_ids":{"minItems":1,"type":"array","items":{"type":"string","minLength":1},"description":"BLS SeriesIDs, trimmed, uppercased, and deduplicated in first-occurrence order. Process up to 25 unique IDs without a key or 50 with one; the exact remainder is returned as unprocessedSeriesIds. The batch costs one API query."},"start_year":{"description":"Start year for the data range (inclusive). BLS allows up to 20 years per request and requires both bounds or neither: supplying start_year alone resolves end_year to the current year, capped at start_year + 19. BLS may reduce this window for unregistered access. Omit both for the BLS three-calendar-year default, subject to series coverage.","type":"integer","minimum":1900,"maximum":2100},"end_year":{"description":"End year for the data range (inclusive). Supplying it without start_year is rejected before the request — BLS applies no default start year alongside an explicit end year. Pair it with start_year, or omit both for the API default window.","type":"integer","minimum":1900,"maximum":2100},"calculations":{"description":"When true, request BLS-computed period-over-period net/percent changes. BLS returns supported types and intervals; some surveys omit calculations while preserving observations, while an explicit unsupported-calculations rejection raises calculations_not_supported. Consult bls_list_surveys for support. Monthly series may return 1, 3, 6, and 12-month intervals. Mirror rows carry no calculations. calculationsApplied is false when any data-bearing series returns no calculation values; notice names affected series and available calculations remain intact.","type":"boolean"},"annual_average":{"default":false,"description":"When true, include BLS-computed annual summary rows named \"Annual\": M13 for monthly series, Q05 for quarterly, S03 for semiannual. These are not universally arithmetic means or additional periods; exclude them from sums or averages over periods. Defaults to false. Independent of year bounds. Surveys without annual summaries return the same rows either way; annualAverageRows reports the count.","type":"boolean"}},"required":["series_ids"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true,"openWorldHint":true},"definitionHash":"f006bcc053f9790ee835b5360b4c1b9f31f91088cba07f0262f71581c72c2261","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:19.378Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/bls-labor-mcp-server","endpointFingerprint":"266efc011453a9d386324b579434164ffe0bfe193b5cd845143633de768a0184","name":"bls_list_surveys","title":"List BLS Surveys","description":"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; each row's searchCoverage says whether bls_search_series reaches the survey through its offline index, composes its SeriesIDs from code tables, or cannot search it, in which case its series are fetched by SeriesID with bls_get_series. Optional category filter narrows results to prices, employment, wages, productivity, injuries, or time_use surveys.","inputSchema":{"type":"object","properties":{"category":{"description":"Optional category filter. One of: prices, employment, wages, productivity, injuries, time_use. A survey can appear under more than one category (CES under employment and wages). Omit to list all surveys.","type":"string","enum":["prices","employment","wages","productivity","injuries","time_use"]}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"idempotentHint":true,"openWorldHint":true},"definitionHash":"dbe36bd92adb3ead6df8b6399d7eb24ea5c20e790242abb1c9a0765a0f8dd084","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:19.378Z","metadataTrust":"untrusted"},{"serverName":"io.github.cyanheads/bls-labor-mcp-server","endpointFingerprint":"266efc011453a9d386324b579434164ffe0bfe193b5cd845143633de768a0184","name":"bls_search_series","title":"Search BLS Series","description":"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 publication frequency for surveys that publish one series at several frequencies) and plain-language names, ranked by relevance and paged with limit and offset. Use this before bls_get_series when you have a concept but not a SeriesID. Operates offline against an index of the major surveys — no API quota consumed. Survey filter accepts the two-letter code of an indexed survey (CU, AP, CE, LN, LA, PC, WP, JT, EC, PR, MP, CW, CM, CI, SM, LE, EI, SU, IP, BD, LU, EE; OE is indexed only when the server sets BLS_CATALOG_INCLUDE_OES=true, and otherwise composes OEWS SeriesIDs from the OE code tables, marked composed and unconfirmed); series in other surveys are fetched by SeriesID with bls_get_series. Area filter accepts place names, USPS state codes, and FIPS, CBSA, and CPI area codes.","inputSchema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"description":"Natural language or keyword query (e.g. \"unemployment rate\", \"CPI food\", \"nonfarm payrolls\"). Also accepts a SeriesID directly for exact lookup."},"survey":{"description":"Two-letter LABSTAT survey abbreviation to filter results, case-insensitive (e.g. CU for CPI, CE for CES, SM for state and metro CES, LN for CPS, LA for LAUS, JT for JOLTS). Indexed surveys: CU, AP, CE, LN, LA, PC, WP, JT, EC, PR, MP, CW, CM, CI, SM, LE, EI, SU, IP, BD, LU, EE; OE (OEWS) is indexed only when the server sets BLS_CATALOG_INCLUDE_OES=true, and without its rows OE composes OEWS SeriesIDs from the OE code tables for the occupation, place, and data type the query and area name, each marked composed. Omit to search all indexed surveys.","type":"string"},"area":{"description":"Geographic area to narrow results to, case-insensitive. A USPS state code (TX) or 2-digit state FIPS code (48) selects the state: its statewide series, the areas in it (metro areas reaching into it included), and series with no decoded area whose title names it. An all-digit area code selects the area it names in every survey that decodes it: 3 digits a combined statistical area (CSA), 4 a CPI area (0000 is the U.S. city average), 5 a county FIPS or metro area (CBSA) code, 7 a city or town (state + place FIPS); a code naming no indexed area returns no series. Any other value, such as a place name (\"Seattle\") or a SeriesID fragment (\"ST48\"), matches as a substring of the area name, title, or SeriesID; another all-digit value does too, with a notice. Under survey OE with no indexed OE rows, area selects the OEWS areas to compose: a USPS state code or 2-digit state FIPS names the state, a 5-digit CBSA or 7-digit OEWS area code (0042660, 5300000) its area, and any other value is a substring of an OEWS area name; each metro or state it names also composes its state and national rows. Without this filter, a place query names in full (every distinctive word of it, e.g. \"black hawk\") ranks first among the series matching every query word; otherwise, among equal matches, current series rank first, then national ones.","type":"string"},"seasonal_adjustment":{"description":"When true, return only seasonally adjusted series. When false, return only not-seasonally-adjusted. Omit to return both.","type":"boolean"},"limit":{"default":10,"description":"Maximum number of results to return (default 10); requests above 50 are clamped to 50 with notice.","type":"integer","minimum":1,"maximum":9007199254740991},"offset":{"default":0,"description":"Number of ranked results to skip, for paging past the first page (default 0). Pass nextOffset from the previous response to get the next page.","type":"integer","minimum":0,"maximum":9007199254740991}},"required":["query"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"readOnlyHint":true,"openWorldHint":false},"definitionHash":"6f3b7ce1fc1d70444268a2d536ee33955b0b7e4d36d9789c72c7347d5b0f89db","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T07:46:19.378Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"266efc011453a9d386324b579434164ffe0bfe193b5cd845143633de768a0184","protocol":"streamable-http","status":"indexed","toolCount":6,"observedAt":"2026-11-19T07:46:19.378Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"io.github.cyanheads/bls-labor-mcp-server":{"url":"https://bls-labor.caseyjhand.com/mcp"}}},"Cursor":{"mcpServers":{"io.github.cyanheads/bls-labor-mcp-server":{"url":"https://bls-labor.caseyjhand.com/mcp"}}},"VS Code":{"servers":{"io.github.cyanheads/bls-labor-mcp-server":{"type":"http","url":"https://bls-labor.caseyjhand.com/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://bls-labor.caseyjhand.com/mcp"},{"protocol":"mcp","package":"@cyanheads/bls-labor-mcp-server","registryType":"npm","version":"0.6.0"},{"protocol":"mcp","package":"@cyanheads/bls-labor-mcp-server","registryType":"npm","version":"0.6.0"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:io.github.cyanheads%2Fbls-labor-mcp-server","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/io.github.cyanheads%2Fbls-labor-mcp-server","name":"io.github.cyanheads/bls-labor-mcp-server","description":"Fetch US Bureau of Labor Statistics data — CPI, unemployment, wages, JOLTS, and more via MCP.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://bls-labor.caseyjhand.com/mcp"},{"protocol":"mcp","package":"@cyanheads/bls-labor-mcp-server","registryType":"npm","version":"0.6.0"},{"protocol":"mcp","package":"@cyanheads/bls-labor-mcp-server","registryType":"npm","version":"0.6.0"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":null,"repositoryUrl":"https://github.com/cyanheads/bls-labor-mcp-server","version":"0.6.0"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"io.github.cyanheads/bls-labor-mcp-server","status":"online","lastCheckedAt":"2026-11-20T09:18:00.769Z","lastSuccessfulCheck":"2026-11-20T09:18:00.769Z","latencyMs":124,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T09:18:00.769Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T09:18:00.769Z"},"security":null,"timestamps":{"createdAt":"2026-10-19T02:06:19.315Z","updatedAt":"2026-10-19T02:06:19.315Z","observedAt":"2026-11-20T09:18:00.769Z"},"compatibility":{"serverVersion":"0.6.0","protocolVersions":[{"protocol":"mcp","version":null}]}}}}