fred-mcp-server

fred-mcp-server

4

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

  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

Development

Run the server in development mode:

npm run dev

Production

  1. Build the project:

    npm run build
    
  2. 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