FRED MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • 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.

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:

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

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

A Model Context Protocol server that provides tools to search and retrieve economic data series from the Federal Reserve Economic Data (FRED) API.

  1. Prerequisites
    1. Installation
      1. Usage
        1. Development
          1. Production
          2. Available Tools
            1. Series Search
              1. Series Observations
              2. Development
                1. Project Structure
                  1. Testing
                  2. License
                    1. Contributing
                      1. Acknowledgments