Federal Reserve Economic Data MCP Server
About
Access financial datasets from the Federal Reserve Economic Data (FRED) API.
Details
- Author
- stefanoamorelli
- GitHub stars
- 104
- Downloads
- 760
- Categories
- Database, Finance, Other, API, Search, AI
Jump to
- 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
Install via Smithery (npx -y @smithery/cli install @stefanoamorelli/fred-mcp-server --client claude) or manually by cloning the repository and building with pnpm. Configure with a FRED API key in your claude_desktop_config.json using a local Node.js binary, Docker container, or streamable HTTP transport (node build/index.js --http). The server provides three tools: fred_browse, fred_search, and fred_get_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"
]
}
}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 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.
