FRED MCP Server

by kablewy

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

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.

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
        2. Production
      2. Available Tools
        1. Series Search
        2. Series Observations
      3. Development
        1. Project Structure
        2. Testing
      4. License
        1. Contributing
          1. Acknowledgments

            Related MCP Servers

            • -
              security
              F
              license
              -
              quality
              A Model Context Protocol server that enables Claude Desktop to access and analyze Chinese and global financial market data through the AKShare library.
              Last updated -
              3
              Python
              • Linux
              • Apple
            • A
              security
              A
              license
              A
              quality
              Provides 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.
              Last updated -
              1
              2
              Python
              MIT License
              • Apple
              • Linux
            • -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that enables AI assistants like Claude to programmatically access financial data from Financial Modeling Prep API, including company profiles, financial statements, metrics, SEC filings, and market data.
              Last updated -
              5
              Python
              MIT License
            • -
              security
              -
              license
              -
              quality
              Provides access to Federal Reserve Economic Data (FRED) through Claude and other LLM clients, enabling users to search for, retrieve, and visualize economic indicators like GDP, employment, and inflation data.
              Last updated -
              7
              Python

            View all related MCP servers

            ID: c6jnc44poi