us-open-stats-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., "@us-open-stats-mcp What's the current unemployment rate in California?"
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.
us-open-stats-mcp
MCP server exposing normalized Census, BLS, FRED, and HUD tools. Returns small typed JSON snapshots suitable for editors and CLI clients.
Agents-first homepage + live infographics (embeddable): us-open-stats-mcp.pages.dev
Install
uv sync --extra dev
./scripts/smoke.shRelated MCP server: Slacking-Biz
Run
uv run us-open-data-mcp serve
uv run python scripts/build_demo_site.py
uv run pytest -qDemo UI: cd site && python3 -m http.server 8789
Infographics app
Premium Vite + React + ECharts reports live in web/. Build emits into site/ (Fraunces + Archivo, donut/hbar/lollipop/scatter/line charts, filterable listings, /embed/:id iframes).
cd web && npm install && npm run build
# or
uv run python scripts/build_demo_site.pyExample MCP client config
{
"mcpServers": {
"us-open-stats": {
"command": "uv",
"args": ["run", "--directory", "/path/to/us-open-stats-mcp", "us-open-data-mcp", "serve"]
}
}
}Tools (MVP)
Tool | Agency |
| Census ACS |
| HUD |
| BLS |
| BLS |
| FRED |
Default responses use recorded fixtures so CI stays offline. For live HUD FMR set HUD_API_TOKEN (optional). Every MCP snapshot includes license_note, vintage, source_url, and retrieved_at.
Live API keys can be added later without changing tool names. FRED tools remain fixture-oriented (see FRED API terms before redistributing live series).
License
MIT — see LICENSE.
Available Tools
5 toolsget_cbsa_populationGet Cbsa PopulationC
Return ACS population estimate for a CBSA.
Inputs: cbsa (required), year. Returns: object
get_cpiGet CpiC
Return a BLS CPI series point.
Inputs: series_id. Returns: object
get_fred_seriesGet Fred SeriesB
Return a FRED series observation from fixtures (live key optional later).
Inputs: series_id (required). Returns: object
get_hud_fmrGet Hud FmrC
Return HUD Fair Market Rent for an entity id.
Inputs: entity_id (required), bedrooms. Returns: object
get_unemployment_rateGet Unemployment RateC
Return BLS unemployment rate for an area code.
Inputs: area. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Most tools target distinct metrics (population, rent, unemployment, CPI), but get_fred_series is a generic catch-all that can fetch the same BLS/CPI series as the specialized tools, creating overlap and potential misselection.
All tools follow a consistent get_<metric> snake_case pattern, making the naming predictable and easy to parse.
Five tools is well-scoped for a focused statistical data server; each tool earns its place without bloat or extreme thinness.
Core economic indicators (population, rent, unemployment, CPI, generic FRED) are covered, but there is no way to list available series, sources, or metadata, which limits discoverability.
Related MCP Connectors
Fetch US Bureau of Labor Statistics data — CPI, unemployment, wages, JOLTS, and more via MCP.
75 MCP tools: SEC financials, FRED economics, IRS 990, FDA, FX, UK Companies House.
Data Commons MCP — harmonised public statistics for places, from Google Data Commons (REST v2).
Housing Intel MCP — Meta-pack that chains FRED, BLS, ATTOM, and HUD APIs into higher-level housing…
Related MCP Servers
AlicenseAqualityDmaintenanceAn MCP server that gives Claude deep access to US public data -- demographics, economics, crime, employment, weather, housing, transit, schools, budgets, and more across 30+ cities for government intelligence workflows.28MIT- AlicenseNot gradedqualityDmaintenance24 MCP tools for SEC financials, FRED economics, US Census demographics, and World Bank data via Streamable HTTP.MIT
- AlicenseAqualityDmaintenanceMCP server serving official statistics from major data agencies (Statistics Canada, FRED, BLS, World Bank, etc.) as tools with provenance and verification, enabling search, retrieval, analysis, and monitoring via natural language.1163 npmMIT
- AlicenseNot gradedqualityCmaintenanceProvides AI assistants with direct access to economic statistics, high-frequency US equity bars, and patent/innovation measures, enabling search, metadata retrieval, and data download through MCP tools.MIT