Advertise
MCP.so
Sign In

MCP FREDAPI

@Jaldekoa

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

Jaldekoa

About MCP FREDAPI

FRED (Federal Reserve Economic Data) API integration with Model Context Protocol (MCP)

#finance#mcp#fred#fred-api#llm#llms#mcp-server

MCP FREDAPI config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-fredapi": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp",
        "--with",
        "httpx",
        "mcp",
        "run",
        "server.py"
      ]
    }
  }
}

MCP FREDAPI tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP-FREDAPI?

MCP-FREDAPI is an MCP server that provides access to economic data from the Federal Reserve Bank of St. Louis (FRED) through the Model Context Protocol. It integrates with the official FRED API, focusing on the series_observations endpoint to retrieve time series data for economic indicators. This server is designed for AI assistants like Claude, enabling them to fetch FRED data directly when used with Cursor or other MCP-compatible environments.

How to use MCP-FREDAPI?

Installation is done via pip (with mcp, httpx, python-dotenv) or uv (recommended). After cloning the repository, set your FRED API key in a .env file. For Cursor, add the server to ~/.cursor/mcp.json using the uv run command. Use the tool @mcp-fredapi:get_fred_series_observations within Claude to query series. Note that only certain parameters currently work: series_id, sort_order, units, frequency, aggregation_method, and output_type. Other parameters like observation_start, limit, and vintage_dates are not working due to MCP limitations.

Key features of MCP-FREDAPI

  • Retrieves economic time series data from FRED
  • Supports multiple frequency, units, and aggregation options
  • Integrates with Claude in Cursor via MCP
  • Uses the official FRED API series_observations endpoint
  • Provides simple parameter set (6 working parameters)
  • Easy configuration with .env file and mcp.json

Use cases of MCP-FREDAPI

  • Getting the latest GDP data from FRED
  • Fetching inflation rate using CPI time series with percent change
  • Retrieving annual GDP data for long‑term trends
  • Sorting observations in descending order (newest first)
  • Obtaining data in different output formats (e.g., output_type 2)

Frequently asked questions

1

What is MCP-FREDAPI used for?

It enables AI assistants to query economic time series from the Federal Reserve’s FRED database directly within MCP-compatible environments like Cursor.

2

How do I get a FRED API key?

You can obtain a free API key from the FRED API website (https://fred.stlouisfed.org/docs/api/api_key.html). Set it in the `FRED_API_KEY` environment variable in a `.env` file.

3

Which parameters of `get_fred_series_observations` currently work?

Only `series_id`, `sort_order`, `units`, `frequency`, `aggregation_method`, and `output_type` are functional. Parameters like `realtime_start`, `realtime_end`, `limit`, `offset`, `observation_start`, `observation_end`, and `vintage_dates` are not working.

4

How do I configure MCP-FREDAPI with Cursor?

Add a configuration entry to `~/.cursor/mcp.json` using the `uv` command pointing to your local repository directory. The README provides a full JSON example.

5

What are common economic series IDs I can use?

Examples include `GDP` (Gross Domestic Product), `CPIAUCSL` (Consumer Price Index), `UNRATE` (Unemployment Rate), `FEDFUNDS` (Federal Funds Rate), and `A191RL1Q225SBEA` (Real GDP). The README lists several common IDs.

Comments

More Other MCP servers

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Advertise