FRED MCP Server
Uses .ENV to manage environment variables, particularly for storing and accessing the FRED API key securely.
Supports Git for version control, with instructions for cloning the repository as part of the installation process.
Hosts the repository at github.com/kablewy/fred-mcp-server, allowing for easy distribution and installation.
Requires Node.js v16 or higher as a runtime environment for the server.
Uses npm for package management, dependency installation, and running server commands through scripts.
Implements the server using TypeScript for type safety, with references to TypeScript interfaces and configuration.
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 MCP Server get the unemployment rate for the last 6 months"
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.
Here's the README formatted in proper markdown:
FRED MCP Server
A Model Context Protocol (MCP) server implementation for accessing the Federal Reserve Economic Data (FRED) API. This server provides tools to search and retrieve economic data series from FRED.
Prerequisites
Node.js (v16 or higher)
FRED API Key (obtain from FRED API)
Related MCP server: FRED MCP Server
Installation
Clone the repository:
git clone https://github.com/kablewy/fred-mcp-server cd fred-mcp-serverInstall dependencies:
npm installCopy the
.env.examplefile to.envand add your FRED API key:FRED_API_KEY=your_api_key_here
Usage
Development
Run the server in development mode:
npm run devProduction
Build the project:
npm run buildStart the server:
npm start
Available Tools
The server provides the following FRED API tools:
Series Search
Search for economic data series using various parameters.
Series Observations
Retrieve observations for a specific economic data series with options for:
Date range filtering
Frequency adjustment
Aggregation methods
Sorting and pagination
Development
Project Structure
fred-mcp-server/
├── src/
│ ├── index.ts # Server entry point
│ ├── tools.ts # Tool implementations
│ └── types.ts # TypeScript interfaces
├── package.json
├── tsconfig.json
└── .envTesting
Run the test suite:
npm testLicense
[Your chosen license]
Contributing
[Your contribution guidelines]
Acknowledgments
Built with Model Context Protocol SDK
Data provided by Federal Reserve Economic Data (FRED)
Available Tools
2 toolsTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have distinct purposes: 'search' is for finding data series, while 'series' is for retrieving observations for a specific series. There is minimal overlap, though the 'advanced options' in both descriptions could cause slight confusion if not detailed further, but the core functions are clearly separated.
Both tool names are single, lowercase nouns ('search' and 'series'), which is consistent and simple. There are no mixed conventions or deviations, making the naming pattern predictable and easy to understand.
With only 2 tools, the server feels thin for a data service like FRED, which typically involves more operations such as listing categories, getting metadata, or managing favorites. This limited set may hinder agents from performing comprehensive tasks in the domain.
The tool surface is severely incomplete for a FRED server. It lacks essential operations like listing available series categories, retrieving series metadata, or supporting updates and deletions. Agents will face significant gaps when trying to navigate or manipulate FRED data beyond basic search and observation retrieval.
Maintenance
Related MCP Connectors
One API and MCP server for financial and economic data: markets, economics, companies and more.
Hosted MCP server for SEC, FRED, Polymarket, Deribit, OKX, and FMP.
FRED MCP — Federal Reserve Economic Data (St. Louis Fed)
FRED macro data, Treasury yields, FX rates & macro indicators for AI agents. Pay-per-query via x402.
Related MCP Servers
- AlicenseCqualityDmaintenanceProvides access to economic data from the Federal Reserve Bank of St. Louis (FRED) through the Model Context Protocol, allowing AI assistants to retrieve economic time series data directly.16MIT
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that provides access to Federal Reserve Economic Data (FRED), enabling users to retrieve, analyze, and compare economic indicators and time series data through natural language.2-
- AlicenseNot gradedqualityBmaintenanceAn MCP server that wraps the Federal Reserve Economic Data (FRED) API, providing access to over 800,000 economic time series like GDP and unemployment. It enables AI agents to search for data, retrieve metadata, and fetch historical observations directly from the St. Louis Fed.Apache 2.0
- FlicenseNot gradedqualityDmaintenanceFastMCP server for querying FRED financial and macroeconomic data, providing tools to search and retrieve economic indicators.-