Happy slice of mcp pizzaMCP.pizza

fred-mcp-server

MCP.Pizza Chef: stefanoamorelli

FRED is the Federal Reserve Bank of St. Louis's public archive of economic data — inflation, unemployment, interest rates, and thousands of other series going back decades. This connects it to an assistant so you can ask for a figure or a trend and get the real numbers rather than a recollection. Useful for anyone writing about or reasoning with economic data. You need a free FRED key. Note this is an independent project, not affiliated with the Federal Reserve.

Data
Web/Research

Use This MCP server To

Look up the current inflation rate Chart how unemployment moved over years Compare two economic measures over time Pull the latest interest rate figures Find a data series on a topic Get real numbers instead of a recollection

README

Federal Reserve Economic Data MCP Server

Important

Disclaimer: This open-source project is not affiliated with, sponsored by, or endorsed by the Federal Reserve or the Federal Reserve Bank of St. Louis. "FRED" is a registered trademark of the Federal Reserve Bank of St. Louis, used here for descriptive purposes only.

A Model Context Protocol (MCP) server for accessing Federal Reserve Economic Data (FRED®) financial datasets.

Tip

If you use this project in your research or work, please cite it using the CITATION.cff file, or the APA format below:

Amorelli, S. (2025). Federal Reserve Economic Data MCP (Model Context Protocol) Server [Computer software]. GitHub. https://github.com/stefanoamorelli/fred-mcp-server

Installation

  1. Clone the repository: 
    git clone https://github.com/stefanoamorelli/fred-mcp-server.git
cd fred-mcp-server
  2. Install dependencies: 
    pnpm install
  3. Build the project: 
    pnpm build

Configuration

This server requires a FRED® API key. You can obtain one from the FRED® website.

Install the server, for example, on Claude Desktop, modify the claude_desktop_config.json file and add the following configuration:

{
  "mcpServers": {
    "FRED MCP Server": {
      "command": "/usr/bin/node",
      "args": [
        "<PATH_TO_YOUR_CLONED_REPO>/fred-mcp-server/build/index.js"
      ],
      "env": {
        "FRED_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Available Tools

RRPONTSYD

  • Description: Retrieve data for Overnight Reverse Repurchase Agreements (RRPONTSYD) from FRED®.
  • Parameters:
    • start_date (string, optional): Start date in YYYY-MM-DD format.
    • end_date (string, optional): End date in YYYY-MM-DD format.
    • limit (number, optional): Maximum number of observations to return.
    • sort_order (enum["asc", "desc"], optional): Sort order of observations.

CPIAUCSL

  • Description: Retrieve data for Consumer Price Index for All Urban Consumers (CPIAUCSL) from FRED®.
  • Parameters:
    • start_date (string, optional): Start date in YYYY-MM-DD format.
    • end_date (string, optional): End date in YYYY-MM-DD format.
    • limit (number, optional): Maximum number of observations to return.
    • sort_order (enum["asc", "desc"], optional): Sort order of observations.

📄 License

Apache 2.0 License © 2025 Stefano Amorelli

fred-mcp-server FAQ

Can I use this to check current economic figures?
Yes — it pulls live from the official FRED archive rather than relying on what the model remembers.
Do I need an account or key?
Yes, a FRED key, which is free to obtain from the St. Louis Fed.
Is this an official Federal Reserve product?
No. It is an independent open-source project and is not affiliated with or endorsed by the Federal Reserve.
Can I use this to compare figures over time?
Yes — the series go back decades, so trends and comparisons are straightforward.
Which apps does it work with?
It is documented for Claude.ai and Claude Desktop.