US Macro MCP server

by hgus107·io.github.hgus107/us-macro-mcp·v0.1.2

No reviews yet

US macroeconomic data from FRED: inflation, employment, growth, housing, rates, recession signals.

B83/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B83/100

full report

Adoption

Growing

0 stars24 downloads/wk

Reviews

Write one

Nobody has reviewed US Macro yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

US Macro tools (8)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

compare_indicators
Compare two or more indicators over the same period, for questions like "did wage growth beat inflation" or "how do the 2-year and 10-year yields compare".
get_history
Get the historical time series for one indicator.
get_indicator
Get the latest value of one economic indicator, with its recent changes already calculated.
list_indicators
List every US economic indicator this server provides.
macro_snapshot
Get a current snapshot of the US economy in one call - the latest value and recent change for every headline indicator.
recession_signals
Check the main US recession warning signals at once - the Sahm rule, the yield curve, credit spreads, jobless claims and financial conditions - each with a plain-English status.
release_calendar
Show which US economic data releases are scheduled over the coming days, for questions like "what economic data comes out this week".
search_indicators
Find indicators by keyword when you do not know the exact name - for example "gas prices", "wages", "mortgage" or "recession".

Public scan report

scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it

no findings

Code scan6 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 29 days ago15/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How US Macro compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 83/100; higher than 65% of 48,255 servers
Tools: 8; the typical server has 7
Tools that change things: 0%; typical: 0%. Fewer write tools means less an agent can break
Downloads a week: 24; more than 10% of 12,191 servers with a package

What its tools let an agent do: 8 read

Install US Macro in Claude Code, Cursor or VS Code

claude mcp add us-macro-mcp -- uvx us-macro-mcp

Add to Cursor

What the publisher says

From the US Macro repository's README, as published. We do not edit it. Read it on GitHub

US-Macro-MCP

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/

Changelog

What it does

Requirements

A free FRED API key. Request one at fredaccount.stlouisfed.org/apikeys — it takes about a minute and costs nothing.

Install

Claude Desktop

Add this to your claudedesktopconfig.json:

{
  "mcpServers": {
    "us-macro": {
      "command": "uvx",
      "args": ["us-macro-mcp"],
      "env": { "FRED_API_KEY": "your_key_here" }
    }
  }
}

Claude Code

claude mcp add us-macro --env FRED_API_KEY=your_key_here -- uvx us-macro-mcp

Any other MCP client

Run uvx us-macro-mcp with FREDAPIKEY set in the environment. The server speaks MCP over stdio.

How it behaves

It runs locally. Nothing is hosted. Your client launches the server as a subprocess on your own machine, using your own API key. No data leaves your computer except the read-only requests to FRED.

It caches. A single macrosnapshot fetches 19 indicators at once, and conversations tend to ask for the same series repeatedly. Answers are held in memory for a period matched to how often the number can actually change — an hour for daily series like Treasury yields, half a day for monthly series like CPI. The cache is discarded when the process exits. Adjust CACHESECONDS in fred.py if you want different behaviour.

It never logs your API key. Requests are logged as endpoint, series and status code only, and any error text is stripped of the key before it is written or returned.

Known limitations

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

US Macro: common questions

Is US Macro MCP server safe?: Mostly: it is graded B (83/100). Read the US Macro safety report
How do I install US Macro?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does US Macro need an API key?: Yes. The registry entry asks for FRED_API_KEY.
Is US Macro maintained?: The last commit was 70 days ago (2026-08-26). The latest release is v0.1.2.
How does US Macro compare with other MCP servers?: safety score 83/100 (higher than 65% of 48,255 servers); tools 8 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.