FRED Economic Data

🚀 FRED MCP Server

A server implementation based on the Model Context Protocol (MCP) for accessing the Federal Reserve Economic Data (FRED) API. This server provides tools to search and retrieve FRED's economic data series.

🚀 Quick Start

✨ Prerequisites

• Node.js (v16 or higher)
• FRED API key (obtained from FRED API)

📦 Installation

1. Clone the repository:

   git clone https://github.com/kablewy/fred-mcp-server
   cd fred-mcp-server
   

2. Install dependencies:

   npm install
   

3. Copy the .env.example file to .env and add your FRED API key:

   FRED_API_KEY=your_api_key_here
   

💻 Usage Examples

🔨 Development Mode

Run the development server:

npm run dev

🚀 Production Mode

1. Build the project:

   npm run build
   

2. Start the server:

   npm start
   

✨ Features

The server provides the following FRED API tools:

🔍 Data Series Search

Search for economic data series using various parameters.

📊 Series Observations

Retrieve observations for a specific economic data series, supporting the following options:

• Date range filtering
• Frequency adjustment
• Aggregation method
• Sorting and pagination

🔧 Technical Details

📁 Project Structure

fred-mcp-server/
├── src/
│   ├── index.ts      # Server entry point
│   ├── tools.ts      # Tool implementation
│   └── types.ts      # TypeScript interfaces
├── package.json
├── tsconfig.json
└── .env

🧪 Testing

Run the test suite:

npm test

📄 License

[Your chosen license]

🤝 Contribution Guidelines

[Your contribution guidelines]

🙏 Acknowledgments

• Built using the Model Context Protocol SDK
• Data provided by Federal Reserve Economic Data (FRED)