Skip to main content
Glama
cre-fred-mcp

cre-fred-mcp

by nik-mirando

cre-fred-mcp

An MCP server that pulls live Federal Reserve economic data (FRED) — the rates a CRE capital-markets routine runs on: SOFR, Treasury yields, the Fed funds rate, mortgage rates, CPI and PCE. Instead of re-scraping by hand, your MCP client pulls the current numbers on every run.

Quickstart — let Claude set it up for you

Not technical? You don't need to be. Hand this repo to Claude and let it do the work:

  1. Open Claude Desktop (or Claude Code).

  2. Give it this repo — paste the URL https://github.com/nik-mirando/cre-fred-mcp (or this README) and say: "Help me install this MCP server in my Claude Desktop, step by step."

  3. Claude walks you through the three things it needs:

    • a free FRED API key (~2 minutes, instant, no credit card — see below),

    • installing the server,

    • adding it to your Claude config and restarting.

Once it's connected, just ask the questions further down and Claude pulls the live numbers itself.

The one step Claude can't do for you is create the free FRED account — it'll hand you the link and tell you exactly where to paste the key. Everything else it handles.

Related MCP server: FRED

Example questions to ask once it's connected

  • "Give me a CRE capital markets snapshot."

  • "What's SOFR today, and the 10-year Treasury?"

  • "What's the current 30-year mortgage rate, and how has it moved this year?"

  • "What's CPI and PCE inflation right now, year over year?"

  • "Pull the Fed funds rate and the 2s/10s Treasury spread."

Tools

Tool

What it returns

get_capital_markets_snapshot

One call: SOFR, UST 2/5/10/30yr, Fed funds, 30yr mortgage (latest %), plus CPI & PCE year-over-year %

get_latest_value(series_id)

Most recent non-missing observation for any series

get_series_observations(series_id, ...)

Time series with date/value (supports units like pc1 = YoY %, and frequency aggregation)

get_series_metadata(series_id)

Title, units, frequency, last updated

search_series(query)

Find series by free-text

list_common_series

Curated CRE-relevant series ids

Missing values (FRED's ".", common on daily series over holidays) are normalised to null, never crash, and are skipped by get_latest_value.

Get a free API key

FRED keys are free and issued instantly:

  1. Create / sign in to a FRED account.

  2. Go to https://fredaccount.stlouisfed.org/apikeys and request a key.

  3. Copy the 32-character key.

Install

# from source (this folder)
pip install .
# or run without installing, via uv
uvx --from . cre-fred-mcp

Set the key (either export it or drop a .env next to the server):

cp .env.example .env   # then paste your key

MCP client config

{
  "mcpServers": {
    "cre-fred": {
      "command": "uvx",
      "args": ["--from", "/abs/path/to/cre-fred-mcp", "cre-fred-mcp"],
      "env": { "FRED_API_KEY": "your_key_here" }
    }
  }
}

(Or "command": "python", "args": ["-m", "cre_fred_mcp"] with the package installed.)

Verify it works (live)

python smoke_test.py

Makes real calls and asserts on real values — e.g. that DGS10 metadata titles the 10-Year Treasury and that the latest SOFR print is a sane numeric rate.

Data source

Data: FRED, Federal Reserve Bank of St. Louis. This is an unofficial client and is not affiliated with or endorsed by the Fed. Series are subject to FRED's terms of use.

Available Tools

6 tools
get_capital_markets_snapshotA

Snapshot of key CRE rates in one call: SOFR, UST 2/5/10/30yr, Fed funds, 30yr mortgage (latest %), plus CPI and PCE (latest year-over-year %).

Inputs: no named parameters.

get_latest_valueA

Most recent non-missing observation for a FRED series.

series_id: FRED series id, e.g. 'SOFR', 'DGS10', 'MORTGAGE30US', 'FEDFUNDS'. Returns {series_id, date (YYYY-MM-DD), value}. Missing/holiday values are skipped so you always get a real number.

Inputs: series_id (required).

get_series_metadataC

Metadata for a FRED series: title, units, frequency, last_updated, notes.

Inputs: series_id (required).

get_series_observationsA

Time series of observations for a FRED series.

Dates are 'YYYY-MM-DD'. frequency aggregates coarser (d,w,m,q,a). units can transform values (e.g. 'pc1' = % change from a year ago, 'pch' = % change). Each row is {date, value (float or null when missing), raw_value}.

Inputs: series_id (required), limit, units, frequency, +3 more.

list_common_seriesA

Curated CRE-relevant FRED series ids this server knows about (id -> label).

Inputs: no named parameters.

search_seriesC

Full-text search FRED for series. Returns id/title/units/frequency/popularity.

Inputs: query (required), limit.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 6 tools

    Disambiguation4/5

    Tools have distinct purposes: snapshot bundles multiple rates, get_latest_value retrieves a single latest observation, get_series_metadata provides metadata, get_series_observations returns time series, list_common_series offers a curated list, and search_series performs full-text search. Some overlap exists between get_latest_value and get_series_observations, but descriptions clarify their distinct use cases.

    Naming Consistency4/5

    Tool names follow a mostly consistent verb_noun pattern: three use 'get_', one 'list_', one 'search_'. The naming is readable and clear, though 'get_capital_markets_snapshot' is a bit verbose compared to others. No mixing of camelCase or snake_case, but the verb prefix varies slightly.

    Tool Count5/5

    With 6 tools, the server is well-scoped for its purpose of providing CRE-relevant FRED data. Each tool serves a specific need without being excessive or insufficient. The count is appropriate for a focused domain-specific server.

    Completeness4/5

    The tool set covers key operations: retrieving data (latest, time series, snapshot), exploring available series (curated list, search), and obtaining metadata. A minor gap might be the lack of a tool to directly compare multiple series side-by-side, but the snapshot and get_series_observations largely cover this.

    Related MCP Connectors

    Related MCP Servers

    • 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
    • F
      license
      A
      quality
      D
      maintenance
      A local MCP server that gives Claude and other MCP clients access to Federal Reserve Economic Data (FRED) — 800,000+ economic time series covering GDP, inflation, employment, interest rates, and more.
      3
      2
      -
    • A
      license
      A
      quality
      C
      maintenance
      Provides curated US economic data from Treasury, FRED, BLS, BEA, and other sources through an MCP interface. Enables querying economic series, fetching data with provenance tracking, and accessing cached artifacts.
      9
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables querying New York Fed markets data—repo and reverse repo auctions, securities lending, SOMA holdings, reference rates, and primary dealer statistics—through MCP tools without an API key.
      99 npm
      MIT