`fred_category`

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

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/fred_category for the schema, then POST the same URL with its arguments for the data.

The economic data series filed under one FRED category, from the St. Louis Fed.

Tool description as the model sees it

Browse economic data by category (housing, employment, money/banking, etc.). Returns subcategories and related series IDs.

Parameters

Name	Type	Required	Description
`category_id`	number	no	Category ID to browse children of (default: 0 for root)
`_apiKey`	string	yes	FRED API key

Example call

Arguments

{
  "category_id": 0,
  "_apiKey": "your-fred-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/fred/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fred_category","arguments":{"category_id":0,"_apiKey":"your-fred-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('fred_category', {
  "category_id": 0,
  "_apiKey": "your-fred-api-key"
});

More examples

{
  "category_id": 113,
  "_apiKey": "your-fred-api-key"
}

Response shape

Always returns: parent_category_id, categories

Field	Type	Description
`parent_category_id`	number	Parent category ID
`categories`	array	Child categories

Full JSON Schema

{
  "type": "object",
  "properties": {
    "parent_category_id": {
      "type": "number",
      "description": "Parent category ID"
    },
    "categories": {
      "type": "array",
      "description": "Child categories",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "description": "Category ID"
          },
          "name": {
            "type": "string",
            "description": "Category name"
          },
          "parent_id": {
            "type": "number",
            "description": "Parent category ID"
          }
        },
        "required": [
          "id",
          "name",
          "parent_id"
        ]
      }
    }
  },
  "required": [
    "parent_category_id",
    "categories"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

fred_category