Skip to main content
Glama
enesjakozh

FRED Macroeconomic Data MCP Server

by hungson175
GitHub
Python
9
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

FRED Macroeconomic Data MCP Server

A Model Context Protocol (MCP) server that provides access to Federal Reserve Economic Data (FRED) through Claude and other LLM clients. This server exposes FRED economic data series, search capabilities, and data retrieval tools.

Features

  • Access to common FRED economic indicators (GDP, Employment, Inflation, etc.)

  • Search functionality for FRED data series

  • Real-time data fetching from FRED API

  • Standardized data format for LLM consumption

  • Built using the MCP Python SDK for seamless integration

Prerequisites

  • Python 3.11 or higher

  • uv - Modern Python package installer

  • Claude Desktop for local usage

  • FRED API Key (get one from FRED API)

Installation

  1. Clone the repository:

git clone https://github.com/yourusername/WM_mcp.git cd WM_mcp

  1. Create and activate a virtual environment using uv:

uv venv source .venv/bin/activate # On Windows, use `.venv\Scripts\activate`

  1. Install dependencies using uv:

uv pip install "mcp[cli]>=1.6.0" "colorama>=0.4.6" "numpy>=2.2.4" "pandas>=2.2.3" "python-dotenv>=1.1.0" "requests>=2.32.3"

  1. Set up environment variables:

cp .env.example .env

Edit .env and add your FRED API key:

FRED_API_KEY=your_fred_api_key_here

Installing in Claude Desktop

  1. Make sure Claude Desktop is installed and running

  2. Open Claude Desktop settings:

    • Go to Settings > Developer > Edit Config

    • Add the following configuration to your claude_desktop_config.json:

{ "mcpServers": { "FRED Macroeconomic Data Server": { "command": "/path/to/your/.local/bin/uv", "args": [ "--directory", "/path/to/your/WM_mcp", "run", "fred_macroeco_server.py" ] } } }

Replace /path/to/your/ with your actual paths. You can find uv's path by running which uv in terminal.

Usage in Claude

  1. First, search online for "using MCP resource in Claude Desktop Client" to understand how to include MCP resources in your conversations.

  2. Once you've added the resource, you can interact with FRED data. Example prompt:

Use FRED APIs to get GDPs of USA last 20 years, draw chart

Available Resources

  • file://series/available - List all available FRED series and their details

Available Tools

  • fetch_series_data - Fetch data for any FRED series

  • search_series - Search for FRED series by description

Development

For development and testing:

  1. Run the MCP Inspector to test the server:

mcp dev fred_macroeco_server.py

This allows you to inspect resources, test tools, and verify server functionality.

  1. For direct server execution (to check for issues):

python fred_macroeco_server.py

Note: The server uses stdio transport for communication with Claude Desktop. Use the MCP Inspector during development to catch and fix any issues before deploying to Claude Desktop.

Troubleshooting

  1. If you get API key errors:

    • Verify your FRED API key is correctly set in .env

    • Check that the .env file is in the correct directory

  2. If the server doesn't appear in Claude Desktop:

    • Double-check your claude_desktop_config.json paths

    • Ensure uv and all dependencies are installed correctly

    • Try restarting Claude Desktop

Acknowledgments

  • Federal Reserve Bank of St. Louis for providing the FRED API

  • Model Context Protocol team for the MCP SDK

  • Anthropic for Claude and the Claude Desktop client

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Provides access to Federal Reserve Economic Data (FRED) through Claude and other LLM clients, enabling users to search for, retrieve, and visualize economic indicators like GDP, employment, and inflation data.

  1. Features
    1. Prerequisites
      1. Installation
        1. Installing in Claude Desktop
          1. Usage in Claude
            1. Available Resources
              1. Available Tools
                1. Development
                  1. Troubleshooting
                    1. Acknowledgments

                      Related MCP Servers

                      • Cryptocurrency Market Data MCP Server

                        Nayshins
                        A
                        security
                        A
                        license
                        A
                        quality
                        Provides real-time and historical cryptocurrency market data through integration with major exchanges. This server enables LLMs like Claude to fetch current prices, analyze market trends, and access detailed trading information.
                        Last updated -
                        7
                        54
                        MIT License
                        • Apple

                      • FRED MCP Server

                        kablewy
                        A
                        security
                        F
                        license
                        A
                        quality
                        A Model Context Protocol server that provides tools to search and retrieve economic data series from the Federal Reserve Economic Data (FRED) API.
                        Last updated -
                        28
                        8

                      • ODBC MCP Server

                        tylerstoltz
                        -
                        security
                        A
                        license
                        -
                        quality
                        Enables LLM tools like Claude Desktop to query databases via ODBC connections, allowing access, analysis, and insight generation from database data while maintaining security through read-only safeguards.
                        Last updated -
                        1
                        MIT License

                      • MCP-FREDAPI

                        Jaldekoa
                        A
                        security
                        A
                        license
                        A
                        quality
                        Provides access to economic data from the Federal Reserve Bank of St. Louis (FRED) through the Model Context Protocol, allowing AI assistants to retrieve economic time series data directly.
                        Last updated -
                        1
                        4
                        MIT License
                        • Apple
                        • Linux

                      View all related MCP servers

                      New MCP Servers

                      MCP directory API

                      We provide all the information about MCP servers via our MCP API.

                      curl -X GET 'https://glama.ai/api/mcp/v1/servers/hungson175/WM_MCP'

                      If you have feedback or need assistance with the MCP directory API, please join our Discord server