fred — The Economic Nerve

Monetary policy, GDP, unemployment, inflation — the macroeconomic forces that move everything. This B1TE reads them directly.

Part of FRE4X-B1TE — a monorepo of MCP servers built for autonomous agents.

The Federal Reserve publishes the data that governments and institutions use to make decisions worth trillions. This server gives the agent that same data stream — unfiltered, paginated, ready for inference. While analysts write reports, the agent already knows.

Tools

| Tool | What it reaches | |------|----------------| | fred_search_series | Full-text search across all FRED series | | fred_get_series_info | Metadata for a series — units, frequency, range, last update | | fred_get_series_data | Observation time-series for any series (e.g. GDP, UNRATE, CPIAUCSL) | | fred_get_category_series | All series under a given FRED category | | fred_get_releases | Index of all FRED data releases | | fred_get_release_series | Series belonging to a specific release | | fred_get_sources | All primary data sources in FRED | | fred_get_source | Details for one source |

All list tools support pagination via limit / offset.

Requirements

A FRED API key (free) — set as FRED_API_KEY.

Mock Mode

Run without an API key (returns fixture data of identical shape):

MOCK=true npx @fre4x/fred

Deploy

{
  "mcpServers": {
    "fred": {
      "command": "npx",
      "args": ["-y", "@fre4x/fred"],
      "env": {
        "FRED_API_KEY": "your_api_key_here"
      }
    }
  }
}

Development

npm install
npm run dev      # tsx, no build
npm run build    # esbuild → dist/
npm test         # vitest unit tests

License

MIT — WE ARE THE FRE4X.