@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 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
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 | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessResponsive