FRED

MCP Server for accessing FRED data

python

2

GitHub Stars

python

Language

6 months ago

First Indexed

2 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": {
    "milind-kulshrestha-fred_mcp_server": {
      "command": "python",
      "args": [
        "-m",
        "fred_mcp_server"
      ],
      "env": {
        "LOG_FILE": "fred_mcp_server.log",
        "LOG_LEVEL": "INFO",
        "FRED_API_KEY": "YOUR_FRED_API_KEY"
      }
    }
  }
}

This MCP server provides access to Federal Reserve Economic Data (FRED) through the Model Context Protocol, enabling you to search series, retrieve time series data, access metadata, and analyze economic trends from a unified interface. It is designed for seamless integration with MCP clients to run analyses, compare indicators, and generate insights from FRED data.

How to use

You interact with this server through an MCP client to perform common economic data tasks. Start the server, connect your MCP client, and run queries to search for indicators, fetch series data, retrieve metadata, and run trend or comparative analyses. The server exposes a consistent set of tools that you can invoke from your client to work with FRED data programmatically.

How to install

Prerequisites: Python 3.10 or higher. A FRED API key is required to access the backend service.

Install from source by following these commands exactly.

# Clone the repository
git clone https://github.com/yourusername/fred-mcp-server.git
cd fred-mcp-server

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install the package (pip)
pip install .

Additional notes and configuration

Configure the server using environment variables. The key required variable is FRED_API_KEY. You can also adjust logging with LOG_LEVEL and specify a log file with LOG_FILE.

To run the server directly, use the Python module form shown here.

python -m fred_mcp_server

Available tools

search_fred_series

Search for economic data series by keywords or category to discover relevant FRED indicators.

fred_get_series_data

Retrieve time series data for a specific economic indicator, with options to specify date ranges.

fred_get_series_metadata

Get detailed metadata about a particular FRED series, including description, units, and source information.

fred_get_category_series

List series within a specific FRED category to explore related indicators.

fred_get_releases

Obtain data releases from FRED to understand update timelines and versioning.

fred_compare_series

Compare multiple economic indicators over a chosen time period to identify relationships.

fred_calculate_statistics

Compute basic statistics (mean, median, min, max) for a FRED series.

fred_detect_trends

Identify trends in FRED data, such as increasing, decreasing, or stable patterns.

analyze_economic_trends

Analyze trends across multiple indicators over time for higher-level economic insights.