FRED Economic

Provides access to 800k+ FRED time series via MCP for fast data access and analysis.

python

0

GitHub Stars

python

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "satendra-mani-tiwari-fred-economic-mcp-server": {
      "command": "python",
      "args": [
        "path/to/fred_economic_server.py"
      ],
      "env": {
        "FRED_API_KEY": "your_api_key_here"
      }
    }
  }
}

You can access Federal Reserve Economic Data (FRED) through an MCP server that exposes 800,000+ time series to Claude and other MCP-compatible clients. This server gives you fast, async data retrieval, historical observations, smart search, and a pre-configured set of key indicators for quick dashboards and comparisons.

How to use

Connect your MCP client to the fred_economic MCP server to retrieve data, run historical analyses, and compare multiple series. Start by running the local server using the provided Python script, then configure your client with the server entry to load data and tools such as get_fred_data, get_fred_historical, and get_multiple_series.

How to install

Prerequisites: Python 3.8 or higher. A FRED API key is required to access data.

# Install Python dependencies
pip install httpx python-mcp python-dotenv

# (Optional) Verify Python version
python --version

Download the server script and prepare your environment. Save the server file as fred_economic_server.py and obtain your FRED API key from your FRED account.

# Set your FRED API key as an environment variable
export FRED_API_KEY="your_api_key_here"

Configure and run the server locally using the example MCP entry. The configuration shows the required command, arguments, and environment for the MCP client to load the server.

{
  "mcpServers": {
    "fred-economic": {
      "command": "python",
      "args": ["path/to/fred_economic_server.py"],
      "env": {
        "FRED_API_KEY": "your_api_key_here"
      }
    }
  }
}

Configuration and usage notes

The server relies on your FRED API key. Ensure you set FRED_API_KEY in the environment where you run the server. If you deploy on a host or container, pass the key as an environment variable in the deployment configuration.

Notes and recommended practices

Use the included tools to retrieve current values, historical data, and multi-series comparisons.
Start with the pre-configured key indicators for quick dashboards and then expand your queries to custom series as needed.

Available tools

get_fred_data

Retrieve data for a single FRED series by its ID, returning the latest value or a specified range.

get_fred_historical

Fetch historical observations for a series over a specified time window, enabling trend analysis.

search_fred

Search for FRED series by keyword or category to discover relevant indicators.

fred_dashboard

Provide access to a set of pre-configured key economic indicators for quick overviews.

get_multiple_series

Compare multiple FRED series side by side to analyze relationships and divergences.