`fred_releases`

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

The economic data releases (e.g. Employment Situation) tracked by FRED, from the St. Louis Fed.

Tool description as the model sees it

Check upcoming and recent economic data releases. Returns release dates, names, and which series they update.

Parameters

Name	Type	Required	Description
`limit`	number	no	Max results (1-1000, default 20)
`offset`	number	no	Result offset for pagination (default 0)
`_apiKey`	string	yes	FRED API key

Example call

Arguments

{
  "limit": 20,
  "_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_releases","arguments":{"limit":20,"_apiKey":"your-fred-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('fred_releases', {
  "limit": 20,
  "_apiKey": "your-fred-api-key"
});

Response shape

Always returns: total_releases, releases

Field	Type	Description
`total_releases`	number	Total number of releases
`returned`	number	How many releases are in `releases` (capped by `limit`, default 20).
`truncated`	boolean	True when `returned` is less than `total_releases`.
`note`	string	Present when the release list was truncated.
`releases`	array	List of economic data releases

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total_releases": {
      "type": "number",
      "description": "Total number of releases"
    },
    "returned": {
      "type": "number",
      "description": "How many releases are in `releases` (capped by `limit`, default 20)."
    },
    "truncated": {
      "type": "boolean",
      "description": "True when `returned` is less than `total_releases`."
    },
    "note": {
      "type": "string",
      "description": "Present when the release list was truncated."
    },
    "releases": {
      "type": "array",
      "description": "List of economic data releases",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "description": "Release ID"
          },
          "name": {
            "type": "string",
            "description": "Name of the release"
          },
          "press_release": {
            "type": "boolean",
            "description": "Whether this is a press release"
          },
          "link": {
            "type": [
              "string",
              "null"
            ],
            "description": "URL link to release details"
          },
          "notes": {
            "type": [
              "string",
              "null"
            ],
            "description": "Additional notes about the release"
          }
        },
        "required": [
          "id",
          "name",
          "press_release",
          "link",
          "notes"
        ]
      }
    }
  },
  "required": [
    "total_releases",
    "releases"
  ]
}

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_releases