`fred_vintage_dates`

Pack: fred · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

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

The ALFRED vintage (revision) dates for one FRED series, from the St. Louis Fed.

Tool description as the model sees it

ALFRED revision history: every date FRED published a new vintage (initial release or a later revision) of a series. Use before fred_revisions to see which dates have a distinct vintage, or pass one of these dates as as_of/realtime_start+realtime_end to fred_get_series to get the data as it stood on that date.

Parameters

Name	Type	Required	Description
`series_id`	string	yes	FRED series ID (e.g., “GDPC1”, “PAYEMS”)
`limit`	number	no	Max vintage dates to return (1-10000, default 100)
`sort_order`	string	no	asc = oldest vintage first, desc = newest vintage first (default desc)
`_apiKey`	string	yes	FRED API key

Example call

Arguments

{
  "series_id": "GDPC1",
  "limit": 10
}

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_vintage_dates","arguments":{"series_id":"GDPC1","limit":10}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('fred_vintage_dates', {
  "series_id": "GDPC1",
  "limit": 10
});

Response shape

Always returns: series_id, total_vintages, returned, truncated, vintage_dates

Field	Type	Description
`series_id`	string	The requested FRED series ID
`total_vintages`	number	Total vintage (revision) dates FRED holds for this series.
`returned`	number	How many vintage dates are in `vintage_dates` (capped by `limit`, default 100).
`truncated`	boolean	True when `returned` is less than `total_vintages` — raise `limit` to see the rest.
`note`	string	Present only when truncated — explains the cap and how to raise it.
`vintage_dates`	array	ALFRED vintage dates (YYYY-MM-DD), newest first by default.

Full JSON Schema

{
  "type": "object",
  "properties": {
    "series_id": {
      "type": "string",
      "description": "The requested FRED series ID"
    },
    "total_vintages": {
      "type": "number",
      "description": "Total vintage (revision) dates FRED holds for this series."
    },
    "returned": {
      "type": "number",
      "description": "How many vintage dates are in `vintage_dates` (capped by `limit`, default 100)."
    },
    "truncated": {
      "type": "boolean",
      "description": "True when `returned` is less than `total_vintages` — raise `limit` to see the rest."
    },
    "note": {
      "type": "string",
      "description": "Present only when truncated — explains the cap and how to raise it."
    },
    "vintage_dates": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "ALFRED vintage dates (YYYY-MM-DD), newest first by default."
    }
  },
  "required": [
    "series_id",
    "total_vintages",
    "returned",
    "truncated",
    "vintage_dates"
  ]
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

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

Connect to just the fred pack

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

See Getting Started for client-specific install steps.

fred_vintage_dates