Federal Reserve Economic Data MCP Server
About
Access financial datasets from the Federal Reserve Economic Data (FRED) API.
Details
- License
- AGPL-3.0
Explore
- Three tools: browse catalog, search series, retrieve data
- Access to over 800,000 FRED economic time series
- Supports data transformations (percent change, log, etc.)
- Frequency aggregation and date range filtering
- Can be run via Docker or streamable HTTP transport
- Optional pagination and sorting for large result sets
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
Federal Reserve Economic Data MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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>"
}
}
}
}
To install Federal Reserve Economic Data Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @stefanoamorelli/fred-mcp-server --client claude
1. Clone the repository:
git clone https://github.com/stefanoamorelli/fred-mcp-server.git
cd fred-mcp-server
2. Install dependencies:
pnpm install
3. Build the project:
pnpm build
TRANSPORT=http node build/index.js
With these three tools, you can:
- Browse all economic categories and discover available data
- Search for specific indicators by keywords or tags
- Retrieve any of the 800,000+ series with custom transformations
- Access real-time economic data including GDP, unemployment, inflation, interest rates, and more
This MCP server provides three comprehensive tools to access all 800,000+ FRED® economic data series:
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"federal reserve economic data mcp server": {
"fred-mcp-server": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@stefanoamorelli/fred-mcp-server",
"--client",
"claude"
]
}
}
}
}McpServers
{
"fred-mcp-server": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@stefanoamorelli/fred-mcp-server",
"--client",
"claude"
]
}
}
> [!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 providing universal access to all 800,000+ Federal Reserve Economic Data (FRED®) time series through three powerful tools.
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 use the following citation:
APA Format:
Amorelli, S. (2025). Federal Reserve Economic Data MCP (Model Context Protocol) Server (Version 1.0.2) [Computer software]. Zenodo. https://doi.org/10.5281/zenodo.14536707
BibTeX:
@software{amorelli_2025_14536707,
author = {Amorelli, Stefano},
title = {{Federal Reserve Economic Data MCP (Model Context
Protocol) Server}},
month = jan,
year = 2025,
publisher = {Zenodo},
version = {1.0.2},
doi = {10.5281/zenodo.14536707},
url = {https://doi.org/10.5281/zenodo.14536707}
}
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
1. Clone the repository:
git clone https://github.com/stefanoamorelli/fred-mcp-server.git
cd fred-mcp-server
2. Install dependencies:
pnpm install
3. 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>"
}
}
}
}
Using Docker
You can also run the FRED MCP Server using Docker. Add this configuration to your claude_desktop_config.json:
{
"mcpServers": {
"fred-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"FRED_API_KEY=<your-key-here>",
"stefanoamorelli/fred-mcp-server:latest"
],
"env": {}
}
}
}
Replace <your-key-here> with your actual FRED API key.
Using Streamable HTTP Transport
For network deployments, you can run the server with Streamable HTTP transport instead of stdio:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
