Federal Reserve Economic Data (FRED)
by
fred-mcp-server is an open-source Model Context Protocol (MCP) server that provides access to Federal Reserve Economic Data (FRED®) financial datasets. It enables applications and services to easily retrieve various economic indicators and financial data directly from FRED.
Federal Reserve Economic Data (FRED) Overview
What is fred-mcp-server?
fred-mcp-server is an open-source Model Context Protocol (MCP) server designed to provide access to Federal Reserve Economic Data (FRED®) financial datasets. It acts as an intermediary, allowing applications and services to easily retrieve various economic indicators and financial data directly from FRED.
How to use fred-mcp-server?
There are two primary ways to install and use fred-mcp-server:
Installing via Smithery
For automated installation, especially for Claude Desktop, you can use Smithery:
npx -y @smithery/cli install @stefanoamorelli/fred-mcp-server --client claude
Manual Installation
- Clone the repository:
git clone https://github.com/stefanoamorelli/fred-mcp-server.git
cd fred-mcp-server
2. **Install dependencies:** bash
pnpm install
3. **Build the project:** bash
pnpm build
```
Configuration
To use the server, you need a FRED® API key, obtainable from the FRED® website. You then configure the server, for example, within Claude Desktop's claude_desktop_config.json:
{
"mcpServers": {
"FRED MCP Server": {
"command": "/usr/bin/node",
"args": [
"<PATH_TO_YOUR_CLONED_REPO>/fred-mcp-server/build/index.js"
],
"env": {
"FRED_API_KEY": "<YOUR_API_KEY>"
}
}
}
}
Key Features of fred-mcp-server
- Access to FRED® Data: Provides programmatic access to a wide range of Federal Reserve Economic Data.
- Model Context Protocol (MCP) Server: Implements the MCP for seamless integration with compatible applications.
- Multiple Data Series: Supports retrieval of various key economic indicators, including:
- Overnight Reverse Repurchase Agreements (
RRPONTSYD) - Consumer Price Index for All Urban Consumers (
CPIAUCSL) - 30-Year Fixed Rate Mortgage Average (
MORTGAGE30US) - 10-Year Treasury Constant Maturity Minus 2-Year Treasury Constant Maturity (
T10Y2Y) - Unemployment Rate (
UNRATE) - Federal Reserve Total Assets (
WALCL) - Gross Domestic Product (
GDP,GDPC1) - 10-Year Treasury Constant Maturity Rate (
DGS10) - S&P/Case-Shiller U.S. National Home Price Index (
CSUSHPINSA) - ICE BofA US High Yield Index Option-Adjusted Spread (
BAMLH0A0HYM2) - 10-Year Breakeven Inflation Rate (
T10YIE) - Inflation, consumer prices for the United States (
FPCPITOTLZGUSA) - Median Sales Price of Houses Sold for the United States (
MSPUS) - M1 Money Stock (
M1SL) - Delinquency Rate on Credit Card Loans, All Commercial Banks (
DRCCLACBS) - Market Yield on U.S. Treasury Securities at 10-Year Constant Maturity, Inflation-Indexed (
DFII10,FII10,WFII10,RIFLGFCY10XIINA)
- Overnight Reverse Repurchase Agreements (
- Flexible Data Retrieval: Allows specifying
start_date,end_date,limit, andsort_orderfor data queries. - Open-Source: Freely available for use and modification under the Apache 2.0 License.
Use Cases of fred-mcp-server
- Financial Analysis: Retrieve and analyze historical and current financial data for research, modeling, and forecasting.
- Economic Research: Access key economic indicators for academic or professional economic studies.
- AI/LLM Applications: Integrate FRED data into AI and Large Language Model (LLM) applications that require real-time or historical economic context.
- Data-Driven Decision Making: Power dashboards and applications that rely on up-to-date economic information.
- Automated Data Pipelines: Build automated systems to fetch and process FRED data for various purposes.
FAQ about fred-mcp-server
Q: Is fred-mcp-server affiliated with the Federal Reserve? A: No, this open-source project is not affiliated with, sponsored by, or endorsed by the Federal Reserve or the Federal Reserve Bank of St. Louis. "FRED" is used for descriptive purposes only.
Q: Do I need an API key to use fred-mcp-server? A: Yes, a FRED® API key is required to access the data. You can obtain one from the FRED® website.
Q: How can I cite this project? A: If you use this project in your research or work, please cite it using the CITATION.cff file, or the APA format provided in the README:
Amorelli, S. (2025). Federal Reserve Economic Data MCP (Model Context Protocol) Server [Computer software]. GitHub. https://github.com/stefanoamorelli/fred-mcp-server
Q: What are the common parameters for data retrieval?
A: All tools accept optional parameters such as start_date (YYYY-MM-DD), end_date (YYYY-MM-DD), limit (maximum observations), and sort_order ("asc" or "desc").
Federal Reserve Economic Data (FRED)'s README
Federal Reserve Economic Data MCP Server
[!IMPORTANT] Disclaimer: This open-source project is not affiliated with, sponsored by, or endorsed by the Federal Reserve or the Federal Reserve Bank of St. Louis. "FRED" is a registered trademark of the Federal Reserve Bank of St. Louis, used here for descriptive purposes only.
A Model Context Protocol (MCP) server for accessing Federal Reserve Economic Data (FRED®) financial datasets.
https://github.com/user-attachments/assets/66c7f3ad-7b0e-4930-b1c5-a675a7eb1e09
[!TIP] If you use this project in your research or work, please cite it using the CITATION.cff file, or the APA format below:
Amorelli, S. (2025). Federal Reserve Economic Data MCP (Model Context Protocol) Server [Computer software]. GitHub. https://github.com/stefanoamorelli/fred-mcp-server
Installation
Installing via Smithery
To install Federal Reserve Economic Data Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @stefanoamorelli/fred-mcp-server --client claude
Manual Installation
- Clone the repository:
git clone https://github.com/stefanoamorelli/fred-mcp-server.git cd fred-mcp-server - Install dependencies:
pnpm install - Build the project:
pnpm build
Configuration
This server requires a FRED® API key. You can obtain one from the FRED® website.
Install the server, for example, on Claude Desktop, modify the claude_desktop_config.json file and add the following configuration:
{
"mcpServers": {
"FRED MCP Server": {
"command": "/usr/bin/node",
"args": [
"<PATH_TO_YOUR_CLONED_REPO>/fred-mcp-server/build/index.js"
],
"env": {
"FRED_API_KEY": "<YOUR_API_KEY>"
}
}
}
}
Available Tools
All tools accept these optional parameters:
start_date(string): Start date inYYYY-MM-DDformat.end_date(string): End date inYYYY-MM-DDformat.limit(number): Maximum number of observations to return.sort_order("asc" | "desc"): Sort order of observations.
RRPONTSYD
- Description: Retrieve data for Overnight Reverse Repurchase Agreements (
RRPONTSYD)
CPIAUCSL
- Description: Retrieve data for Consumer Price Index for All Urban Consumers (
CPIAUCSL)
MORTGAGE30US
- Description: Retrieve data for 30-Year Fixed Rate Mortgage Average in the United States (
MORTGAGE30US)
T10Y2Y
- Description: Retrieve data for 10-Year Treasury Constant Maturity Minus 2-Year Treasury Constant Maturity (
T10Y2Y)
UNRATE
- Description: Retrieve data for Unemployment Rate (
UNRATE)
WALCL
- Description: Retrieve data for Federal Reserve Total Assets (
WALCL)
GDP
- Description: Retrieve data for Gross Domestic Product (
GDP)
GDPC1
- Description: Retrieve data for Real Gross Domestic Product (
GDPC1)
DGS10
- Description: Retrieve data for 10-Year Treasury Constant Maturity Rate (
DGS10)
CSUSHPINSA
- Description: Retrieve data for S&P/Case-Shiller U.S. National Home Price Index (
CSUSHPINSA)
BAMLH0A0HYM2
- Description: Retrieve data for ICE BofA US High Yield Index Option-Adjusted Spread (
BAMLH0A0HYM2)
T10YIE
- Description: Retrieve data for 10-Year Breakeven Inflation Rate (
T10YIE)
FPCPITOTLZGUSA
- Description: Retrieve data for Inflation, consumer prices for the United States (
FPCPITOTLZGUSA)
MSPUS
- Description: Retrieve data for Median Sales Price of Houses Sold for the United States (
MSPUS)
M1SL
- Description: Retrieve data for M1 Money Stock (
M1SL)
DRCCLACBS
- Description: Retrieve data for Delinquency Rate on Credit Card Loans, All Commercial Banks (
DRCCLACBS)
DFII10
- Description: Retrieve data for Market Yield on U.S. Treasury Securities at 10-Year Constant Maturity, Inflation-Indexed (Daily) (
DFII10)
FII10
- Description: Retrieve data for Market Yield on U.S. Treasury Securities at 10-Year Constant Maturity, Inflation-Indexed (Monthly) (
FII10)
WFII10
- Description: Retrieve data for Market Yield on U.S. Treasury Securities at 10-Year Constant Maturity, Inflation-Indexed (Weekly) (
WFII10)
RIFLGFCY10XIINA
- Description: Retrieve data for Market Yield on U.S. Treasury Securities at 10-Year Constant Maturity, Inflation-Indexed (Annual) (
RIFLGFCY10XIINA)
Testing
See TESTING.md for more details.
# Run all tests
pnpm test
# Run specific tests
pnpm test:registry
📄 License
Federal Reserve Economic Data (FRED) Reviews
Login Required
Please log in to share your review and rating for this MCP.
Actions
Federal Reserve Economic Data (FRED)'s Information
- Author
- stefanoamorelli
- Category
- Data & Analytics
- Language
- TypeScript
- License
- Apache License 2.0
- Version
- v0.4.1
- Stars
- 23
- Updated
- 3 months ago
Related MCP Servers
Discover more MCP servers with similar functionality and use cases
Vizro
by mckinsey
Build high-quality data visualization apps quickly with low‑code configuration, leveraging Plotly, Dash, and Pydantic while allowing deep customisation through Python, JavaScript, HTML, and CSS.
AntV Chart
by antvis
mcp-server-chart is a Model Context Protocol (MCP) server developed by AntV that generates over 25 types of visual charts. It provides robust chart generation and data analysis capabilities, integrating with various AI clients and platforms.
Data Exploration
by reading-plus-ai
mcp-server-data-exploration is an MCP server designed for autonomous data exploration on CSV-based datasets. It acts as a personal Data Scientist assistant, providing intelligent insights with minimal effort.
Wren Engine
by Canner
Wren Engine is a semantic engine designed for Model Context Protocol (MCP) clients and AI agents, enabling accurate and context-aware access to enterprise data.
QuickChart
by GongRzhe
A Model Context Protocol (MCP) server for generating various types of charts using QuickChart.io, enabling chart creation through MCP tools.
BigQuery
by ergut
mcp-bigquery-server is a Model Context Protocol (MCP) server that enables Large Language Models (LLMs) to securely and efficiently interact with Google BigQuery datasets. It acts as a translator, allowing LLMs to query and analyze data in BigQuery using natural language instead of SQL.
Mcp Vegalite Server
by isaacwasserman
Provides tools for saving data tables and generating Vega‑Lite visualizations via an MCP interface, supporting both textual specifications and PNG image output.
Google Analytics
by surendranb
Google Analytics MCP Server is a Python-based tool that enables Large Language Models (LLMs) to access and analyze Google Analytics 4 (GA4) data using natural language, providing conversational querying of over 200 GA4 dimensions and metrics.
Mcp Tinybird
by tinybirdco
Provides a Model Context Protocol server implementation for Tinybird, allowing analytics agents to forward data to Tinybird's platform.