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

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

To install Federal Reserve Economic Data Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @stefanoamorelli/fred-mcp-server --client claude

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

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": [
        "/fred-mcp-server/build/index.js"
      ],
      "env": {
        "FRED_API_KEY": ""
      }
    }
  }
}

• Description: Retrieve data for Overnight Reverse Repurchase Agreements (RRPONTSYD)

• Description: Retrieve data for Consumer Price Index for All Urban Consumers (CPIAUCSL)

• Description: Retrieve data for 30-Year Fixed Rate Mortgage Average in the United States (MORTGAGE30US)

• Description: Retrieve data for 10-Year Treasury Constant Maturity Minus 2-Year Treasury Constant Maturity (T10Y2Y)

• Description: Retrieve data for Unemployment Rate (UNRATE)

• Description: Retrieve data for Federal Reserve Total Assets (WALCL)

• Description: Retrieve data for Gross Domestic Product (GDP)

• Description: Retrieve data for Real Gross Domestic Product (GDPC1)

• Description: Retrieve data for 10-Year Treasury Constant Maturity Rate (DGS10)

• Description: Retrieve data for S&P/Case-Shiller U.S. National Home Price Index (CSUSHPINSA)

• Description: Retrieve data for ICE BofA US High Yield Index Option-Adjusted Spread (BAMLH0A0HYM2)

• Description: Retrieve data for 10-Year Breakeven Inflation Rate (T10YIE)

• Description: Retrieve data for Inflation, consumer prices for the United States (FPCPITOTLZGUSA)

• Description: Retrieve data for Median Sales Price of Houses Sold for the United States (MSPUS)

• Description: Retrieve data for M1 Money Stock (M1SL)

• Description: Retrieve data for Delinquency Rate on Credit Card Loans, All Commercial Banks (DRCCLACBS)

• Description: Retrieve data for Market Yield on U.S. Treasury Securities at 10-Year Constant Maturity, Inflation-Indexed (Daily) (DFII10)

• Description: Retrieve data for Market Yield on U.S. Treasury Securities at 10-Year Constant Maturity, Inflation-Indexed (Monthly) (FII10)

• Description: Retrieve data for Market Yield on U.S. Treasury Securities at 10-Year Constant Maturity, Inflation-Indexed (Weekly) (WFII10)

• Description: Retrieve data for Market Yield on U.S. Treasury Securities at 10-Year Constant Maturity, Inflation-Indexed (Annual) (RIFLGFCY10XIINA)

See TESTING.md for more details.

# Run all tests
pnpm test

# Run specific tests
pnpm test:registry

Apache 2.0 License © 2025 Stefano Amorelli