Skip to main content
Glama
FRED MCP Server
by kablewy

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)

Related MCP server: FRED MCP Server

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

Available Tools

2 tools
seriesC

Get observations for a specific FRED data series with advanced options

Inputs: seriesId (required), startDate, endDate, sortOrder, +6 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 2 tools

    Disambiguation4/5

    The two tools have distinct purposes: 'search' is for finding data series, while 'series' is for retrieving observations for a specific series. There is minimal overlap, though the 'advanced options' in both descriptions could cause slight confusion if not detailed further, but the core functions are clearly separated.

    Naming Consistency5/5

    Both tool names are single, lowercase nouns ('search' and 'series'), which is consistent and simple. There are no mixed conventions or deviations, making the naming pattern predictable and easy to understand.

    Tool Count2/5

    With only 2 tools, the server feels thin for a data service like FRED, which typically involves more operations such as listing categories, getting metadata, or managing favorites. This limited set may hinder agents from performing comprehensive tasks in the domain.

    Completeness2/5

    The tool surface is severely incomplete for a FRED server. It lacks essential operations like listing available series categories, retrieving series metadata, or supporting updates and deletions. Agents will face significant gaps when trying to navigate or manipulate FRED data beyond basic search and observation retrieval.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      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.
      1
      6
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that provides access to Federal Reserve Economic Data (FRED), enabling users to retrieve, analyze, and compare economic indicators and time series data through natural language.
      2
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      An MCP server that wraps the Federal Reserve Economic Data (FRED) API, providing access to over 800,000 economic time series like GDP and unemployment. It enables AI agents to search for data, retrieve metadata, and fetch historical observations directly from the St. Louis Fed.
      Apache 2.0