README.md
Access Federal Reserve Economic Data (FRED) economic indicators and series.
mcp-fred
Access Federal Reserve Economic Data (FRED) — economic indicators, time series, and releases.
Tools
| Tool | Description |
|---|---|
search_series |
Search for FRED economic data series by keyword |
get_series |
Get metadata for a specific FRED series |
get_observations |
Get data points (observations) for a FRED series |
get_categories |
Browse the FRED category tree |
get_releases |
Get economic data releases and schedules |
get_popular_series |
Get recently updated/popular FRED series |
Configuration
| Variable | Required | Description |
|---|---|---|
FRED_API_KEY |
Yes | fred api key |
Installation
git clone https://github.com/PetrefiedThunder/mcp-fred.git
cd mcp-fred
npm install
npm run build
Usage with Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"fred": {
"command": "node",
"args": ["/path/to/mcp-fred/dist/index.js"],
"env": {
"FRED_API_KEY": "your-fred-api-key"
}
}
}
}
Usage with npx
npx mcp-fred
License
MIT
Tools (6)
search_seriesSearch for FRED economic data series by keywordget_seriesGet metadata for a specific FRED seriesget_observationsGet data points (observations) for a FRED seriesget_categoriesBrowse the FRED category treeget_releasesGet economic data releases and schedulesget_popular_seriesGet recently updated/popular FRED seriesEnvironment Variables
FRED_API_KEYrequiredfred api keyConfiguration
claude_desktop_config.json
{"mcpServers": {"fred": {"command": "node", "args": ["/path/to/mcp-fred/dist/index.js"], "env": {"FRED_API_KEY": "your-fred-api-key"}}}}Try it
→Search for economic series related to 'GDP' and provide the metadata for the most relevant one.
→Get the latest observations for the unemployment rate series.
→What are the most popular economic data series currently being tracked on FRED?
→List the upcoming economic data releases for this week.