@cyanheads/bls-labor-mcp-server
by cyanheads
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOGS_DIR | No | Directory for log files (Node.js only). | <project-root>/logs |
| BLS_API_KEY | No | BLS v2 API key. Optional — 25 req/day without, 500 req/day with. Register free at bls.gov/developers. | |
| BLS_BASE_URL | No | BLS API v2 base URL. | https://api.bls.gov/publicAPI/v2 |
| OTEL_ENABLED | No | Enable OpenTelemetry instrumentation. | false |
| MCP_AUTH_MODE | No | Auth mode: none, jwt, or oauth. | none |
| MCP_HTTP_PORT | No | HTTP server port. | 3010 |
| MCP_LOG_LEVEL | No | Log level (RFC 5424). | info |
| MCP_TRANSPORT_TYPE | No | Transport: stdio or http. | stdio |
| BLS_CATALOG_DB_PATH | No | On-disk SQLite catalog index — queried on demand and persisted across restarts. Empty uses an in-memory DB (re-harvested each boot). Mount a volume here in containers. | .cache/bls-catalog.db |
| BLS_CATALOG_BASE_URL | No | LABSTAT flat-file base URL. Override to point at a local mirror. | https://download.bls.gov/pub/time.series |
| CANVAS_PROVIDER_TYPE | No | Set to duckdb to enable DataCanvas tabular spillover for large result sets. | none |
| BLS_CATALOG_INCLUDE_OES | No | Include the OES/OEWS wage survey (~6M series / ~1.2 GB; multi-minute first harvest). Off by default — OES series stay fetchable by ID. | false |
| BLS_DATASET_TTL_SECONDS | No | Per-dataframe TTL for canvas-registered tables, in seconds. | 86400 |
| BLS_DATAFRAME_DROP_ENABLED | No | Expose bls_dataframe_drop. TTL handles cleanup by default. | false |
| BLS_CATALOG_CACHE_TTL_HOURS | No | Catalog freshness window in hours — re-harvest once the index is older. | 168 |
| BLS_OBSERVATIONS_MIRROR_ENABLED | No | Serve observations from a local SQLite mirror instead of the live API (requires a one-time bootstrap). | false |
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/cyanheads/bls-labor-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server