fred-mcp 0.1.0b0

A fully-featured FRED MCP server.

Federal Reserve Economic Data MCP Server

[!NOTE] 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 fully-featured Model Context Protocol (MCP) server for accessing Federal Reserve Economic Data (FRED®) financial datasets.

This MCP server uses fred-py-api under the hood.

Installation

pip install fred-mcp

Integration

Easily use this MCP Server in a desktop client of your choosing.

Recommended

Claude Desktop

{
  "mcpServers": {
    "FRED MCP Server": {
      "command": "/path/to/fred-mcp",
      "env": {
        "FRED_API_KEY": "<your api key>"
      }
    }
  }
}

5ire

{
  "name": "FRED MCP Server",
  "description": "Get FRED data via MCP",
  "command": "/path/to/fred-mcp",
  "env": {
    "FRED_API_KEY": "<your api key>"
  },
  "isActive": true,
  "key": "FredMcpServer",
  "type": "local"
}

mcphost

{
  "mcpServers": {
    "fred": {
      "command": "/path/to/fred-mcp",
      "env": {
        "FRED_API_KEY": "<your api key>"
      }
    }
  }
}

Run Server

Command-Line

export FRED_API_KEY=your_api_key
fred-mcp

Docker

[!TIP] You can also use the docker image to run this MCP server with any of the integration clients.

{
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e", "MCP_SERVER_TRANSPORT=stdio",
    "-e", "FRED_API_KEY=your_api_key",
    "ghcr.io/zachspar/fred-mcp/fred-mcp-server:latest"
  ]
}

docker run -d -p 8000:8000 -e FRED_API_KEY=your_api_key --name fred-mcp-server ghcr.io/zachspar/fred-mcp/fred-mcp-server:latest