Skip to main content
Glama
OpenUSPublicDataMCP

OpenUSPublicDataMCP

OpenUSPublicDataMCP

Federal-first, no-key-first MCP access to high-value US public data sources.

This is the US counterpart to OpenUKPublicDataMCP, but it deliberately separates federal coverage from the fragmented state and local ecosystem. Reusable Socrata, ArcGIS REST and CKAN adapters provide platform coverage without pretending that jurisdictions share one schema.

Current bootstrap status

  • FastMCP server with stdio transport

  • source registry with provenance metadata

  • health_check

  • list_public_data_sources

  • find_us_data_sources — filter the registry by jurisdiction or platform

  • resolve_us_geography — resolve state names/abbreviations/city-state strings to state FIPS

  • search_data_gov against the official Data.gov CKAN API (endpoint under re-discovery after live 404)

  • get_census_state_population against the official Census ACS API (optional key)

  • list_federal_agencies against the official USAspending API (no key)

  • search_federal_register against the official Federal Register API (no key)

  • search_usaspending_awards against the official USAspending awards API (no key)

  • search_congress_bills against the official Congress.gov API (optional key)

  • search_socrata_catalog and query_socrata_dataset

  • query_arcgis_feature_service

  • search_ckan_catalog

  • list_curated_state_portals — California, New York, Texas, Washington and Florida

  • search_state_data — dispatch to the selected state's curated portal

  • mocked tests and project verification spine

Related MCP server: PubRecords MCP

Current status

Q2 2026 validation is complete: 16 MCP tools, five curated state portal packs, stdio and Streamable HTTP transport, DynamicMCPProxy catalogue metadata, and a React/Leaflet US discovery explorer. See docs/tests/Q2-executive-report.md for the evidence-based executive snapshot.

Web discovery explorer

./scripts/run-web.sh
# http://127.0.0.1:8787

The explorer maps all 50 states plus DC using approximate label centroids, distinguishes the five curated official state portals, searches the registered federal/state-local source catalogue, and preserves jurisdiction, auth, platform, licence and coverage status. It is a discovery surface—not a claim of complete state/local coverage or analytical boundary data. Development instructions are in web/README.md.

Quick start

cd OpenUSPublicDataMCP
python3.11 -m venv .venv
. .venv/bin/activate
pip install -e '.[dev]'
pytest
fastmcp inspect src/openuspublicdata_mcp/server.py:mcp
fastmcp list src/openuspublicdata_mcp/server.py --json
fastmcp call src/openuspublicdata_mcp/server.py search_data_gov query='climate' limit=3 --json

Direction

  1. Curated state packs and local discovery.

  2. Federal breadth: BLS, BEA, NOAA, EPA, FDA, CDC and USDA.

  3. County FIPS, congressional districts and richer Census geography.

  4. HTTP deployment, DynamicMCPProxy and Hermes registration.

See docs/plans/2026-07-11-openuspublicdata-mcp-bootstrap.md and research/LINKS.md.

HTTP transport

OPENUS_PORT=8787 .venv/bin/openuspublicdata-http
curl http://127.0.0.1:8787/health
# MCP endpoint: http://127.0.0.1:8787/mcp

The DynamicMCPProxy catalogue entry is in integrations/dynamic-mcp-proxy-user-catalogue-entry.json. Hermes can use the stdio server directly:

hermes config set mcp_servers.openuspublicdata.command "/absolute/path/to/OpenUSPublicDataMCP/.venv/bin/python"
hermes config set mcp_servers.openuspublicdata.args '["-m", "openuspublicdata_mcp.server"]'

Available Tools

16 tools
find_us_data_sourcesC

Find registered sources by jurisdiction or platform, such as federal, socrata or ckan.

Inputs: platform, jurisdiction. Returns: object

get_census_state_populationA

Return Census ACS 5-year total population by US state for a supported year.

Inputs: year. Returns: object

health_checkA

Return server health and the count of registered public-data sources.

Inputs: no named parameters. Returns: object

list_curated_state_portalsC

List the first curated state open-data portal pack.

Inputs: no named parameters. Returns: object

list_federal_agenciesA

Return federal agencies known to USAspending.gov without requiring an API key.

Inputs: no named parameters. Returns: object

list_public_data_sourcesA

List registered US public-data sources with jurisdiction and authentication metadata.

Inputs: no named parameters. Returns: object

query_arcgis_feature_serviceC

Query an ArcGIS REST feature service layer.

Inputs: service_url (required), limit, where. Returns: object

query_socrata_datasetC

Read rows from a Socrata dataset using its domain and four-character dataset ID.

Inputs: domain (required), dataset_id (required), limit. Returns: object

resolve_us_geographyA

Resolve a US state name, abbreviation, or city/state string to state FIPS metadata.

Inputs: location (required). Returns: object

search_ckan_catalogC

Search a CKAN catalogue hosted by a state, county, city or public institution.

Inputs: query (required), base_url (required), limit. Returns: object

search_congress_billsC

Search recent Congress.gov bill records; requires CONGRESS_API_KEY.

Inputs: query (required), limit. Returns: object

search_data_govC

Search Data.gov's official catalogue for datasets matching a query.

Inputs: query (required), limit. Returns: object

search_federal_registerC

Search official Federal Register documents by full-text term.

Inputs: query (required), limit. Returns: object

search_socrata_catalogC

Discover state and local datasets hosted on Socrata.

Inputs: query (required), limit. Returns: object

search_state_dataC

Search the curated official open-data portal for a supported US state.

Inputs: query (required), state (required), limit. Returns: object

search_usaspending_awardsC

Search federal spending awards by keyword through USAspending.gov.

Inputs: query (required), limit. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 16 tools

    Disambiguation4/5

    Most tools have distinct targets (Socrata, CKAN, ArcGIS, etc.), but `find_us_data_sources` and `list_public_data_sources` could be confused as both deal with listing sources. Descriptions help differentiate, but slight overlap exists.

    Naming Consistency4/5

    Tools consistently use snake_case with a verb_noun pattern (e.g., query_socrata_dataset). Minor deviation: `health_check` is not verb_noun but still clear. Overall pattern is predictable.

    Tool Count5/5

    16 tools cover a broad range of US public data sources (federal, state, local) without being overwhelming. Each tool serves a distinct purpose in data discovery and querying.

    Completeness4/5

    Tools cover major platforms (Socrata, CKAN, ArcGIS, Data.gov) and federal data sources. Missing a dedicated CKAN dataset query tool (only search exists), but overall coverage is strong for a read-only discovery server.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Access EPA environmental data — facility compliance (ECHO), toxic releases (TRI), Superfund sites, drinking water systems, environmental justice screening (EJScreen), and real-time air quality (AirNow) via MCP.
      238 npm
      2
      Apache 2.0