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

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

P

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K
Advertise