fred-mcp-server
The FRED MCP Server is designed to facilitate access to the Federal Reserve Economic Data (FRED) API, allowing users to search and retrieve economic data series efficiently. It offers tools for series search and observation retrieval with advanced options.
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)
Installation
-
Clone the repository:
git clone https://github.com/kablewy/fred-mcp-server cd fred-mcp-server
-
Install dependencies:
npm install
-
Copy the
.env.example
file to.env
and add your FRED API key:FRED_API_KEY=your_api_key_here
Usage
Development
Run the server in development mode:
npm run dev
Production
-
Build the project:
npm run build
-
Start 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
└── .env
Testing
Run the test suite:
npm test
License
[Your chosen license]
Contributing
[Your contribution guidelines]
Acknowledgments
- Built with Model Context Protocol SDK
- Data provided by Federal Reserve Economic Data (FRED)