{"openapi":"3.0.3","info":{"title":"Gnist Context — BLS (Bureau of Labor Statistics)","description":"U.S. labor statistics including employment, CPI, wages, and unemployment data.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/bls/`\n- **Toolkit page:** `/toolkits/bls`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/bls/get_series":{"post":{"tags":["Economics"],"summary":"get_series","description":"Get time series data from the Bureau of Labor Statistics.\n\nBLS publishes official US government data on employment, unemployment,\nconsumer prices (CPI), producer prices (PPI), productivity, wages, and\noccupational statistics. This tool fetches observations when you know\nthe series ID.\n\nCommon series IDs:\n- LNS14000000 — Unemployment Rate (monthly, seasonally adjusted)\n- CES0000000001 — Total Nonfarm Payrolls (monthly, seasonally adjusted)\n- CUUR0000SA0 — CPI-U All Items (monthly, not seasonally adjusted)\n- CUSR0000SA0 — CPI-U All Items (monthly, seasonally adjusted)\n- CUUR0000SA0L1E — CPI-U Core (less food and energy)\n- WPU00000000 — PPI All Commodities\n- CES0500000003 — Average Hourly Earnings, Total Private\n- PRS85006092 — Nonfarm Business Labor Productivity\n\nUse get_popular_series() to browse curated series by category, or check\nhttps://data.bls.gov/dataQuery/find for the full BLS series catalog.\n\nArgs:\n    series_id: BLS series identifier (e.g. \"CUUR0000SA0\", \"LNS14000000\").\n    start_year: Start year (YYYY). If omitted, BLS returns the latest 3 years\n                (10 years without API key).\n    end_year: End year (YYYY). If omitted, fetches to the latest available.\n    calculations: Include net changes and percent changes (1, 3, 6, 12 month).\n                  Requires API key.\n    annual_averages: Include annual average values alongside monthly data.\n                     Requires API key.\n\nReturns:\n    series_id, observation_count, and observations list with year, period,\n    period_name, value, and optional latest flag and calculations.","operationId":"bls_get_series","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"series_id":{"description":"BLS series identifier (e.g. \"CUUR0000SA0\", \"LNS14000000\").","type":"string"},"start_year":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Start year (YYYY). If omitted, BLS returns the latest 3 years (10 years without API key)."},"end_year":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"End year (YYYY). If omitted, fetches to the latest available."},"calculations":{"default":false,"description":"Include net changes and percent changes (1, 3, 6, 12 month). Requires API key.","type":"boolean"},"annual_averages":{"default":false,"description":"Include annual average values alongside monthly data. Requires API key.","type":"boolean"}},"required":["series_id"],"type":"object"}}}}}},"/rest/bls/get_latest":{"post":{"tags":["Economics"],"summary":"get_latest","description":"Get the most recent observation for a BLS series.\n\nConvenience wrapper that fetches a series and returns only the latest\ndata point. Useful for quick lookups like \"what is the current\nunemployment rate?\" or \"what is the latest CPI reading?\".\n\nArgs:\n    series_id: BLS series identifier (e.g. \"LNS14000000\" for unemployment rate).\n\nReturns:\n    series_id, year, period, period_name, and value of the most recent observation.","operationId":"bls_get_latest","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"series_id":{"description":"BLS series identifier (e.g. \"LNS14000000\" for unemployment rate).","type":"string"}},"required":["series_id"],"type":"object"}}}}}},"/rest/bls/get_multiple_series":{"post":{"tags":["Economics"],"summary":"get_multiple_series","description":"Fetch multiple BLS series in a single request.\n\nRetrieves data for up to 50 series at once (25 without API key).\nUseful for comparing indicators side by side, e.g. unemployment rate\nalongside CPI and nonfarm payrolls.\n\nArgs:\n    series_ids: List of BLS series IDs (max 50 with key, 25 without).\n    start_year: Start year (YYYY).\n    end_year: End year (YYYY).\n\nReturns:\n    count and list of series, each with series_id, observation_count, and observations.","operationId":"bls_get_multiple_series","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"series_ids":{"description":"List of BLS series IDs (max 50 with key, 25 without).","items":{"type":"string"},"type":"array"},"start_year":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Start year (YYYY)."},"end_year":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"End year (YYYY)."}},"required":["series_ids"],"type":"object"}}}}}},"/rest/bls/get_popular_series":{"post":{"tags":["Economics"],"summary":"get_popular_series","description":"Browse curated popular BLS series organized by category.\n\nReturns well-known, commonly-referenced BLS series IDs with titles.\nUse this when you need to find the right series ID for employment,\nprices, productivity, or wages data.\n\nAvailable categories:\n- employment — unemployment rate, nonfarm payrolls, labor force, JOLTS\n- prices — CPI-U (all items, core, food, shelter, gasoline), PPI\n- productivity — labor productivity, unit labor costs, real compensation\n- wages — employment cost index, average hourly earnings, median weekly earnings\n\nArgs:\n    category: Filter to a specific category. If omitted, returns all categories.\n\nReturns:\n    If category specified: category name and list of series (series_id, title).\n    If omitted: list of category names and all series grouped by category.","operationId":"bls_get_popular_series","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter to a specific category. If omitted, returns all categories."}},"type":"object"}}}}}},"/rest/bls/report_feedback":{"post":{"tags":["Economics"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"bls_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Economics","description":"Data sources: Economics"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}