`bls_popular_series`

Pack: bls · Endpoint: https://gateway.pipeworx.io/bls/mcp

Browse popular BLS series by category: employment, inflation, wages, housing, productivity. Returns series IDs and descriptions. Start here to explore available data.

Parameters

Name	Type	Required	Description
`category`	string	no	Filter by category: housing, employment, prices, wages, productivity (optional, returns all if omitted)

Example call

Arguments

{
  "category": "employment"
}

curl

curl -X POST https://gateway.pipeworx.io/bls/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"bls_popular_series","arguments":{"category":"employment"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('bls_popular_series', {
  "category": "employment"
});

More examples

{
  "category": "inflation"
}

Response shape

Always returns: filter_category, total_series, categories

Field	Type	Description
`filter_category`	string \| null	Category filter applied, or null if none
`total_series`	integer	Total number of series in response
`categories`	object	Popular series grouped by category

Full JSON Schema

{
  "type": "object",
  "properties": {
    "filter_category": {
      "type": [
        "string",
        "null"
      ],
      "description": "Category filter applied, or null if none"
    },
    "total_series": {
      "type": "integer",
      "description": "Total number of series in response"
    },
    "categories": {
      "type": "object",
      "description": "Popular series grouped by category",
      "additionalProperties": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "series_id": {
              "type": "string",
              "description": "BLS series ID"
            },
            "title": {
              "type": "string",
              "description": "Series title"
            },
            "description": {
              "type": "string",
              "description": "Series description"
            }
          },
          "required": [
            "series_id",
            "title",
            "description"
          ]
        }
      }
    }
  },
  "required": [
    "filter_category",
    "total_series",
    "categories"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "bls": {
      "url": "https://gateway.pipeworx.io/bls/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

bls_popular_series