FRED Macroeconomic Data
About
Connects to the FRED API to retrieve real-time economic data series including GDP, employment statistics, inflation metrics, and monetary policy indicators for data-driven analyses and visualizations.
Details
- Author
- hungson175
- Repository
- hungson175/WM_MCP
- GitHub stars
- 9
- Categories
- AI, Design, Developer Tools, Search, API, Infrastructure, Frontend
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
FRED Macroeconomic DataCommand (node, npx, python, etc.)/path/to/your/.local/bin/uvArguments-
Argument 1
--directory -
Argument 2
/path/to/your/WM_mcp -
Argument 3
run -
Argument 4
fred_macroeco_server.py
Environment-
FRED_API_KEY
your_fred_api_key_here
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Clone the repository:
git clone https://github.com/yourusername/WM_mcp.git
cd WM_mcp
2. Create and activate a virtual environment using uv:
uv venv
source .venv/bin/activate # On Windows, use .venv\Scripts\activate
3. 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"
4. Set up environment variables:
cp .env.example .env
Edit
.env and add your FRED API key:FRED_API_KEY=your_fred_api_key_here
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"
]
}
}
}
/path/to/your/ with your actual paths. You can find uv's path by running which uv in terminal.
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
fetch_series_data
Fetch data for any FRED series.
search_series
Search for FRED series by description.
- fetch_series_data - Fetch data for any FRED series
- search_series - Search for FRED series by description
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"fred macroeconomic data": {
"env": {
"FRED_API_KEY": "your_fred_api_key_here"
},
"args": [
"--directory",
"/path/to/your/WM_mcp",
"run",
"fred_macroeco_server.py"
],
"command": "/path/to/your/.local/bin/uv"
}
}
}Linux
{
"env": {
"FRED_API_KEY": "your_fred_api_key_here"
},
"args": [
"--directory",
"/path/to/your/WM_mcp",
"run",
"fred_macroeco_server.py"
],
"command": "/path/to/your/.local/bin/uv"
}Macos
{
"env": {
"FRED_API_KEY": "your_fred_api_key_here"
},
"args": [
"--directory",
"/path/to/your/WM_mcp",
"run",
"fred_macroeco_server.py"
],
"command": "/path/to/your/.local/bin/uv"
}Windows
{
"env": {
"FRED_API_KEY": "your_fred_api_key_here"
},
"args": [
"--directory",
"/path/to/your/WM_mcp",
"run",
"fred_macroeco_server.py"
],
"command": "/path/to/your/.local/bin/uv"
}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
2. Create and activate a virtual environment using uv:
uv venv
source .venv/bin/activate # On Windows, use .venv\Scripts\activate
3. 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"
4. 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"
]
}
}
}
/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.
2. For direct server execution (to check for issues):
python fred_macroeco_server.py
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
