cre-fred-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@cre-fred-mcp Give me a CRE capital markets snapshot."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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:
Open Claude Desktop (or Claude Code).
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."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 |
| One call: SOFR, UST 2/5/10/30yr, Fed funds, 30yr mortgage (latest %), plus CPI & PCE year-over-year % |
| Most recent non-missing observation for any series |
| Time series with date/value (supports |
| Title, units, frequency, last updated |
| Find series by free-text |
| 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:
Create / sign in to a FRED account.
Go to https://fredaccount.stlouisfed.org/apikeys and request a key.
Copy the 32-character key.
Install
# from source (this folder)
pip install .
# or run without installing, via uv
uvx --from . cre-fred-mcpSet the key (either export it or drop a .env next to the server):
cp .env.example .env # then paste your keyMCP 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.pyMakes 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 toolsget_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
Scored across 6 tools
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.
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.
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.
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
One API and MCP server for financial and economic data: markets, economics, companies and more.
Fetch US Bureau of Labor Statistics data — CPI, unemployment, wages, JOLTS, and more via MCP.
GDP, unemployment, CPI, interest rates, and 800K+ economic time series from the Federal Reserve
Unlock the power of real-time financial data with our Finance MCP. Easily retrieve the latest
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceAn 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
- FlicenseAqualityDmaintenanceA 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.32-
- AlicenseAqualityCmaintenanceProvides 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.9MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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 npmMIT