FRED Economic MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@FRED Economic MCP Servershow me the latest unemployment rate"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
FRED Economic MCP Server
A powerful Model Context Protocol (MCP) server providing access to Federal Reserve Economic Data (FRED) through Claude and other MCP-compatible clients.
🌟 Features
📊 Comprehensive Data Access: Access to 800,000+ economic time series
🔍 Smart Search: Find economic indicators by keyword or category
📈 Historical Analysis: Retrieve up to 100,000 observations per series
⚡ High Performance: Efficient async operations with proper error handling
🎯 Economic Dashboard: Pre-configured key economic indicators
🔄 Multi-Series Support: Compare multiple economic series simultaneously
Related MCP server: FRED API MCP Server
🚀 Quick Start
Prerequisites
Python 3.8 or higher
FRED API key (free from FRED)
Installation
Download the server file:
Download
fred_economic_server.pyfrom this repository
Install dependencies:
pip install httpx python-mcp python-dotenvGet your FRED API key:
Sign up for a free account
Generate your API key
Set up environment:
export FRED_API_KEY="your_api_key_here"Usage with Claude Desktop
Add to your Claude Desktop configuration (claude_desktop_config.json):
{
"mcpServers": {
"fred-economic": {
"command": "python",
"args": ["path/to/fred_economic_server.py"],
"env": {
"FRED_API_KEY": "your_api_key_here"
}
}
}
}🛠️ Available Tools
Tool | Description | Example Usage |
| Get economic data by series ID | GDP, unemployment, inflation |
| Retrieve 4+ years of data | Long-term trend analysis |
| Find series by keyword | Search "housing prices" |
| Key economic indicators | GDP, unemployment, rates |
| Compare multiple series | GDP vs unemployment |
📊 Example Queries
Basic Data Retrieval
Ask Claude: "Get the latest GDP data"
Uses: get_fred_data("GDP")Historical Analysis
Ask Claude: "Show me 10 years of unemployment data"
Uses: get_fred_historical("UNRATE", years=10)Economic Research
Ask Claude: "Compare inflation and unemployment over the last 5 years"
Uses: get_multiple_series(["CPIAUCSL", "UNRATE"])📈 Common Economic Series
Indicator | Series ID | Description |
GDP |
| Gross Domestic Product |
Unemployment |
| Unemployment Rate |
Inflation |
| Consumer Price Index |
Fed Funds Rate |
| Federal Funds Rate |
10-Year Treasury |
| 10-Year Treasury Rate |
S&P 500 |
| S&P 500 Index |
📞 Support
📧 Issues: Use GitHub Issues for bug reports and feature requests
📖 FRED API Docs: https://fred.stlouisfed.org/docs/api/
🔧 MCP Protocol: https://modelcontextprotocol.io/
📄 License
This project is licensed under the MIT License.
This server cannot be deployed
Maintenance
Related MCP Connectors
Equip AI with tools for researching economic data from Federal Reserve Economic Data (FRED).
GDP, unemployment, CPI, interest rates, and 800K+ economic time series from the Federal Reserve
FRED macro data, Treasury yields, FX rates & macro indicators for AI agents. Pay-per-query via x402.
Macro data for AI agents: GDP, inflation, unemployment and more (World Bank, US BLS). No keys.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides 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.8-
- FlicenseAqualityDmaintenanceEnables searching and retrieving economic data from the Federal Reserve Economic Data (FRED) API, including time series, categories, releases, and popular indicators.71-
- AlicenseAqualityDmaintenanceEnables users to search, retrieve, and explore economic data series from the Federal Reserve Economic Data (FRED) API using natural language.11MIT
- AlicenseAqualityCmaintenanceEnables LLM agents to query US macroeconomic time series from FRED, including GDP, CPI, unemployment, and interest rates, for contextual research.6MIT