bls-labor-mcp-server
io.github.cyanheads/bls-labor-mcp-servercyanheadsstreamable-httpv0.8.0Scanned
Fetch US Bureau of Labor Statistics data — CPI, unemployment, wages, JOLTS, and more via MCP.
6 tools: 1 change things and 5 only read.
- Reads private data · 1
- Reads text others write · 3
- Can send data out · 0
- 1 finding
Tools listed without sign-in. Remote posture
With Anlyon
1 tool here changes things. Govern it.
- Anlyon lists the tools and adopts none.
- Each tool you adopt gets approvals and receipts.
- Your agent never holds the key.
A tool your agent calls directly is not routed through Anlyon and is not governed by it. Anlyon Radar only lists and labels, and these labels are the same either way.
What the bls-labor-mcp-server can do
The bls-labor-mcp-server is published by the GitHub account cyanheads. It has 6 tools. It can create or change data (1 tool: bls_dataframe_query), but cannot delete data. 5 tools only read.
1 tool reads private data (bls_dataframe_query); 3 tools bring in text other people can write (bls_list_surveys, bls_get_latest and bls_get_series).
The fixed checks matched 1 finding (annotation-conflict). Each one comes with the text it matched.
Its remote endpoint lists its tools without sign-in, and its tools changed 3 times since Anlyon Radar first saw them.
Last scanned Nov 15, 2026, version 0.8.0.
Tools
Grouped by what each tool does, most consequential first. Open one for its reasons and full description; descriptions are the publisher's own words.
6 tools
Changes things 1Claude Code: ask
bls_dataframe_queryRun a single-statement SELECT against the canvas dataframes registered by bls_get_series or by an earlier register_as.Reads private data1 finding
Why it is in this group
- The name "bls_dataframe_query" says "query": a word for reading.
- The description's first verb is "run": a word for a change.
- The input takes a statement or command to run (input.sql), which can change anything it can reach.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
What it can reach
- private-dataThe name says "query" and the input takes a statement (input.sql): it reads databases.
Findings
- Warn
The server marks "bls_dataframe_query" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"idempotentHint":true,"openWorldHint":false}; The name "bls_dataframe_query" says "query": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
- openWorldHint: false
Only reads 5Show 5 read-only tools
bls_dataframe_describeList 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.No findings
Why it is in this group
- The name "bls_dataframe_describe" says "describe": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
- openWorldHint: false
bls_get_latestReturn the single most recent observation for BLS series.Reads text others writeNo findings
Why it is in this group
- The name "bls_get_latest" says "get": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
- openWorldHint: true
bls_get_seriesFetch BLS time-series data in a single API request (one query).Reads text others writeNo findings
Why it is in this group
- The name "bls_get_series" says "get": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
- openWorldHint: true
bls_list_surveysList BLS survey programs with their abbreviation codes, full names, and metadata about calculation support and annual averages.Reads text others writeNo findings
Why it is in this group
- The name "bls_list_surveys" says "list": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- idempotentHint: true
- openWorldHint: true
bls_search_seriesSearch the BLS series catalog by natural language query, survey code, geographic area, or keywords to resolve cryptic SeriesIDs.No findings
Why it is in this group
- The name "bls_search_series" says "search": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Exfil surface
Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.
No private-data, untrusted-input, outbound path in this server alone: no tool is tagged outbound.
- Reads private data1
- Reads files, mail, messages, databases, secrets, calendars or repositories.
- Reads text others write3
- Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
- Can send data out0
- Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.
Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.
Remote posture
What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.
Looked at Nov 20, 2026, 19:24 UTC, unchanged since Oct 22, 2026. No credentials were sent and no tool was called. What is looked at.
- Reachable
- yes
- HTTP status of an anonymous initialize
- 200
- tools/list served without credentials
- yes
- Tools that change things, listed without credentials
- 1
- Protocol version
- 2025-06-18
- WWW-Authenticate on 401
- not observed
- resource_metadata in WWW-Authenticate
- not observed
- RFC 9728 protected resource metadata
- not observed
- Authorization servers
- not observed
- Legacy HTTP+SSE transport
- no
- Dynamic client registration
- not observed
- Client ID metadata documents
- not observed
- WarnThe whole server
The endpoint served tools/list without credentials, and the list has 1 tool that changes things (1 write). Whether a call also works without credentials was not tested: tools are never called.
What this check looks forMatched text
https://bls-labor.caseyjhand.com/mcp: tools/list returned 6 tools to an anonymous client, including bls_dataframe_query (write)
Findings
Matches of fixed checks, with the text they matched.
The server marks "bls_dataframe_query" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"idempotentHint":true,"openWorldHint":false}; The name "bls_dataframe_query" says "query": a word for reading.
History
Changes to its tool definitions and to its remote endpoint, newest first.
Tools1 changed.~1 changedView diff
- Changed:bls_dataframe_queryChanges thingsdescription
Tools2 changed.~2 changedView diff
- Changed:bls_list_surveysOnly readsdescription
- Changed:bls_search_seriesOnly readsdescriptioninputSchema
Tools6 changed.~6 changedView diff
- Changed:bls_dataframe_describeOnly readsdescription
- Changed:bls_dataframe_queryChanges thingsdescriptioninputSchema
- Changed:bls_get_latestOnly readsdescriptioninputSchema
- Changed:bls_get_seriesOnly readsdescriptioninputSchemaannotations
- Changed:bls_list_surveysOnly readsannotations
- Changed:bls_search_seriesOnly readsinputSchemaannotations
Install
Pinned to version 0.8.0. Values in angle brackets are yours to fill in.
claude mcp add --transport http bls-labor https://bls-labor.caseyjhand.com/mcpclaude mcp add --transport http bls-labor https://bls-labor.caseyjhand.com/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__bls-labor__bls_list_surveys",
"mcp__bls-labor__bls_search_series",
"mcp__bls-labor__bls_get_latest",
"mcp__bls-labor__bls_get_series",
"mcp__bls-labor__bls_dataframe_describe"
],
"ask": [
"mcp__bls-labor__bls_dataframe_query"
],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as bls-labor. Review it before you use it.
Capability tags behind 4 rules
- mcp__bls-labor__bls_list_surveys untrusted-input
- mcp__bls-labor__bls_get_latest untrusted-input
- mcp__bls-labor__bls_get_series untrusted-input
- mcp__bls-labor__bls_dataframe_query private-data
Pin
Keep the decision: fail CI when the tools change, follow every change, or show a badge.
Pin in CI
Fail a build when the tools you reviewed are not the tools the server serves today.
curl -s "https://radar.anlyon.com/api/v1/servers/io.github.cyanheads/bls-labor-mcp-server/verify?hash=6395aa872ba329ee9ff286bdb48b294fa5cfb808d2739e87414408f97a847d8b" | jq -e '.changed == false'Pinned hash 6395aa872ba3, from Nov 15, 2026, 04:18 UTC.
Watch
Get told when its tools change: a new tool, a new description, a new class.
https://radar.anlyon.com/servers/io.github.cyanheads/bls-labor-mcp-server/changes.xmlAn Atom feed. Works in any feed reader or Slack's RSS app.
Badge
[](https://radar.anlyon.com/servers/io.github.cyanheads/bls-labor-mcp-server)Source: MCP Registry · repository. Synced Nov 15, 2026, 04:17 UTC.
bls-labor-mcp-server: questions and answers
Answered from the scan above, not from the publisher's description.
Is the bls-labor-mcp-server safe?
- No scan can promise that. What its definitions show: 6 tools, 1 of which can change, send or delete something, and 1 finding from fixed checks. Allow the reads, ask before each change, and deny the deletes; the permissions block on this page does that.
Can the bls-labor-mcp-server delete data?
- No tool is classed as destructive: going by their definitions, none of them deletes, cancels or revokes anything.
Can the bls-labor-mcp-server do things that cannot be undone?
- No tool is classed as irreversible: none of them sends, pays, publishes or merges, going by their definitions.
What tools does the bls-labor-mcp-server have?
- 6 tools: 1 write, 5 read. bls_dataframe_query, bls_list_surveys, bls_search_series, bls_get_latest, bls_get_series and bls_dataframe_describe.
Does the bls-labor-mcp-server need sign-in or OAuth?
- Its remote endpoint listed its tools to an anonymous client, without sign-in.
Does the bls-labor-mcp-server send data to outside services?
- None of its tools sends, posts or publishes, or takes a recipient, channel or URL.
Has the bls-labor-mcp-server changed its tools?
- Yes, 3 times since Anlyon Radar started tracking it, most recently on Nov 15, 2026. Every change is on this page and in its Atom feed.