`fred_series_info`

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

Get metadata for a series: title, units, frequency, seasonal adjustment, notes, and date range. Check this before fetching historical data.

Parameters

Name	Type	Required	Description
`series_id`	string	yes	FRED series ID (e.g., “MORTGAGE30US”)
`_apiKey`	string	yes	FRED API key

Example call

Arguments

{
  "series_id": "MORTGAGE30US",
  "_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_series_info","arguments":{"series_id":"MORTGAGE30US","_apiKey":"your-fred-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('fred_series_info', {
  "series_id": "MORTGAGE30US",
  "_apiKey": "your-fred-api-key"
});

Response shape

Always returns: series_id, title, units, units_short, frequency, frequency_short, seasonal_adjustment, seasonal_adjustment_short, observation_start, observation_end, last_updated, popularity, notes

Field	Type	Description
`series_id`	string	FRED series ID
`title`	string	Full title of the series
`units`	string	Units of measurement
`units_short`	string	Abbreviated units
`frequency`	string	Data frequency description
`frequency_short`	string	Abbreviated frequency code
`seasonal_adjustment`	string	Seasonal adjustment description
`seasonal_adjustment_short`	string	Abbreviated seasonal adjustment code
`observation_start`	string	First available observation date
`observation_end`	string	Latest available observation date
`last_updated`	string	Last update timestamp
`popularity`	number	Series popularity score
`notes`	string \| null	Additional notes and methodology

Full JSON Schema

{
  "type": "object",
  "properties": {
    "series_id": {
      "type": "string",
      "description": "FRED series ID"
    },
    "title": {
      "type": "string",
      "description": "Full title of the series"
    },
    "units": {
      "type": "string",
      "description": "Units of measurement"
    },
    "units_short": {
      "type": "string",
      "description": "Abbreviated units"
    },
    "frequency": {
      "type": "string",
      "description": "Data frequency description"
    },
    "frequency_short": {
      "type": "string",
      "description": "Abbreviated frequency code"
    },
    "seasonal_adjustment": {
      "type": "string",
      "description": "Seasonal adjustment description"
    },
    "seasonal_adjustment_short": {
      "type": "string",
      "description": "Abbreviated seasonal adjustment code"
    },
    "observation_start": {
      "type": "string",
      "description": "First available observation date"
    },
    "observation_end": {
      "type": "string",
      "description": "Latest available observation date"
    },
    "last_updated": {
      "type": "string",
      "description": "Last update timestamp"
    },
    "popularity": {
      "type": "number",
      "description": "Series popularity score"
    },
    "notes": {
      "type": [
        "string",
        "null"
      ],
      "description": "Additional notes and methodology"
    }
  },
  "required": [
    "series_id",
    "title",
    "units",
    "units_short",
    "frequency",
    "frequency_short",
    "seasonal_adjustment",
    "seasonal_adjustment_short",
    "observation_start",
    "observation_end",
    "last_updated",
    "popularity",
    "notes"
  ]
}

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_series_info