OpenUSPublicDataMCP
Provides tools to query ArcGIS feature services, allowing AI agents to access and analyze geospatial data from ArcGIS REST endpoints.
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., "@OpenUSPublicDataMCP search for climate datasets on data.gov"
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.
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_checklist_public_data_sourcesfind_us_data_sources— filter the registry by jurisdiction or platformresolve_us_geography— resolve state names/abbreviations/city-state strings to state FIPSsearch_data_govagainst the official Data.gov CKAN API (endpoint under re-discovery after live 404)get_census_state_populationagainst the official Census ACS API (optional key)list_federal_agenciesagainst the official USAspending API (no key)search_federal_registeragainst the official Federal Register API (no key)search_usaspending_awardsagainst the official USAspending awards API (no key)search_congress_billsagainst the official Congress.gov API (optional key)search_socrata_catalogandquery_socrata_datasetquery_arcgis_feature_servicesearch_ckan_cataloglist_curated_state_portals— California, New York, Texas, Washington and Floridasearch_state_data— dispatch to the selected state's curated portalmocked 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:8787The 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 --jsonDirection
Curated state packs and local discovery.
Federal breadth: BLS, BEA, NOAA, EPA, FDA, CDC and USDA.
County FIPS, congressional districts and richer Census geography.
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/mcpThe 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 toolsfind_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
Scored across 16 tools
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.
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.
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.
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
MCP access to the U.S. federal procurement graph: contracts, opportunities, entities, and more.
DataDC MCP — Washington, DC open data (opendata.dc.gov, ArcGIS REST API).
Hosted MCP server for finding authoritative primary data sources and official portals.
Search and preview datasets publicly. Account-required full data via MCP.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables querying Washington DC open data from opendata.dc.gov and ArcGIS REST API through MCP.86 npmMIT
- AlicenseNot gradedqualityCmaintenanceAggregate US business filings, SEC reports, federal court cases, federal spending awards, and professional licenses through a single MCP server.1MIT
- AlicenseNot gradedqualityBmaintenanceSearch and query government open-data portals (Socrata SODA API) via MCP.592 npm4Apache 2.0
- AlicenseNot gradedqualityBmaintenanceAccess 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 npm2Apache 2.0