US macroeconomic data from FRED: inflation, employment, growth, housing, rates, recession signals.
MCPpedia last refreshed this data
io.github.hgus107/us-macro-mcp is an MCP server that US macroeconomic data from FRED: inflation, employment, growth, housing, rates, recession signals. Its tool list has not been published yet over stdio, requires no API key, and scores 82/100 on MCPpedia's security, maintenance and efficiency rubric.
Config is the same across clients - only the file and path differ.
{
"mcpServers": {
"us-macro": {
"env": {
"FRED_API_KEY": "your_key_here"
},
"args": [
"us-macro-mcp"
],
"command": "uvx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
US macroeconomic data from FRED: inflation, employment, growth, housing, rates, recession signals.
Run this in your terminal to verify the server starts. Then let us know if it worked - your result helps other developers.
uvx 'us-macro-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories - click any category to see the underlying evidence.
No known CVEs.
Checked us-macro-mcp against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience - it helps other developers decide.
Sign in to write a review.
Others in other
Private-by-default, local-first memory/context/task orchestrator for MCP apps and agents.
Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 60-95% fewer tokens, same answers. Library, proxy, MCP server.
SQL for Android APK and DEX files: classes, methods, strings, references and smali.
A curated list of skills, tools, tutorials, and capabilities for AI coding agents (Claude, Codex, Antigravity, Copilot, VS Code)
MCP Security Weekly
Get CVE alerts and security updates for io.github.hgus107/us-macro-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
An MCP server that gives AI assistants clean access to US macroeconomic data — 58 indicators covering inflation, employment, growth, housing, consumer behaviour, interest rates, financial stress, markets and federal finances, sourced from the Federal Reserve's FRED database.
It is built so the assistant never has to know a FRED series ID, and never has to do arithmetic. Ask for cpi and you get the latest reading, the previous one, the year-ago value, and the percentage changes already calculated.
Registry Official Link : https://pypi.org/project/us-macro-mcp/
| Date | Version | Comment |
|---|---|---|
| 2026-07-27 | 0.1.2 | Added OS and Python version classifiers, changelog, and contact address switched to GitHub noreply. |
| 2026-07-27 | 0.1.1 | Added mcp-name marker for registry ownership verification. First version listed in the official MCP registry. |
| 2026-07-27 | 0.1.0 | Initial release — 58 indicators, 8 tools. Yanked; superseded by 0.1.1. |
| Tool | What you use it for |
|---|---|
list_indicators | See every indicator available, grouped by category |
get_indicator | The current reading of one indicator, with its changes |
get_history | A full time series, for trends and charting |
compare_indicators | Two or more indicators over the same window, normalised for comparison |
release_calendar | Which economic reports are scheduled over the coming days |
macro_snapshot | The whole economy — or one category — in a single call |
recession_signals | The Sahm rule, yield curve, credit spreads, claims and financial conditions, each graded |
search_indicators | Find an indicator by keyword when you don't know its name |
A free FRED API key. Request one at fredaccount.stlouisfed.org/apikeys — it takes about a minute and costs nothing.
Install uv and make sure
uvx is on the PATH available to Codex. The plugin launches the published PyPI
release us-macro-mcp==0.1.2 locally over stdio; it requires Python 3.10 or newer.
Its launcher constrains the MCP SDK to >=1.2,<2 because this release uses the
SDK's v1 FastMCP API.
Make your FRED_API_KEY environment variable available to the Codex app before
starting it. The plugin forwards that variable to the MCP server; it does not
store the key in its files or prompt for it during installation.
On macOS, run this locally, then fully quit and reopen Codex:
launchctl setenv FRED_API_KEY 'YOUR_FRED_API_KEY'
Replace the placeholder with your own key. Do not commit or share the key.
launchctl setenv applies to the current login session; repeat it after logging
back in. On Linux, export the variable before launching Codex from that shell;
on Windows, set a user environment variable and restart Codex.
In Codex, open Plugins → Add → Add plugin marketplace.
Set Source to Signal-Drifts/US-Macro-MCP (or
https://github.com/Signal-Drifts/US-Macro-MCP.git), set Git ref to main,
leave Sparse paths empty, and click Add marketplace.
Select Signal Drifts and install US Macro, then start a new chat.
Try: “Use US Macro to list the available indicators,” then ask for a macro snapshot. Listing indicators checks discovery; live data also requires the FRED key and network access to FRED.
You can also register the marketplace with the Codex CLI:
codex plugin marketplace add Signal-Drifts/US-Macro-MCP --ref main
The catalog is at .agents/plugins/marketplace.json; the plugin manifest and MCP
configuration are under plugins/us-macro-mcp/. The plugin package has its own
version: plugin 0.1.4 uses PyPI server 0.1.2. When updating the server release,
update the pinned PyPI version in the