Skip to main content
Glama
us-open-stats-mcp

us-open-stats-mcp

by yoshibase

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.sh

Related MCP server: Slacking-Biz

Run

uv run us-open-data-mcp serve
uv run python scripts/build_demo_site.py
uv run pytest -q

Demo 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.py

Example 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

get_cbsa_population

Census ACS

get_hud_fmr

HUD

get_unemployment_rate

BLS

get_cpi

BLS

get_fred_series

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 tools
get_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

    B3.1/5.0

    Scored across 5 tools

    Disambiguation3/5

    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.

    Naming Consistency5/5

    All tools follow a consistent get_<metric> snake_case pattern, making the naming predictable and easy to parse.

    Tool Count5/5

    Five tools is well-scoped for a focused statistical data server; each tool earns its place without bloat or extreme thinness.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An 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.
      28
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      11
      63 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides 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