{"title":"HIFLD Next public API","description":"Read-only JSON metadata and download links for geospatial datasets, plus bounded same-origin query resources for the first-party workspace. This is not OGC API-Features or STAC: there are no /items, /features, or numeric dataset IDs in URLs. Use collection and dataset slugs; follow links in each JSON response.","links":{"self":"http://hifld.publicenvirodata.org/api","openapi":"http://hifld.publicenvirodata.org/api/openapi","llms_txt":"http://hifld.publicenvirodata.org/llms.txt","agent_skills":"http://hifld.publicenvirodata.org/.well-known/agent-skills/index.json","api_catalog":"http://hifld.publicenvirodata.org/.well-known/api-catalog","mcp_server_card":"http://hifld.publicenvirodata.org/.well-known/mcp/server-card.json","ai_catalog":"http://hifld.publicenvirodata.org/.well-known/ai-catalog.json","mcp":"http://hifld.publicenvirodata.org/mcp","health":"http://hifld.publicenvirodata.org/api/health","collections":"http://hifld.publicenvirodata.org/api/collections","example_collection_datasets":"http://hifld.publicenvirodata.org/api/collections/hifld?search=wastewater&limit=25&omit=description","create_query":"http://hifld.publicenvirodata.org/api/queries","query_page":"http://hifld.publicenvirodata.org/api/queries/{query_id}/pages","query_bounds":"http://hifld.publicenvirodata.org/api/queries/{query_id}/bounds","query_tile":"http://hifld.publicenvirodata.org/api/queries/{query_id}/tiles/{z}/{x}/{y}.mvt"},"hints":{"search_params_on_collection_list_only":"Use GET /api/collections/{slug} with query params: search, tag_filters, limit, offset, omit (not q= on other paths).","discovery":"Read /llms.txt and GET /api/openapi before guessing URLs. Scanner clients can read the JSON MCP Server Card and ARD at their well-known paths, then use same-origin /mcp.","bulk_analysis":"For statewide filters, download GeoParquet/Shapefile from file metadata `links` or source URLs and use DuckDB or GeoPandas locally.","query_resources":"POST /api/queries starts a bounded query. Page and bounds resources require X-HIFLD-Query-Token; their query_id path is bound to that token. Bounds are computed lazily for map framing. Stable problem responses never expose SQL, credentials, physical paths, or tokens. Load MVT directly from the returned public dataset-mcp URL; the webapp does not proxy tiles.","catalog_writes":"The JSON catalog API remains read-only. Contextual browser WebMCP tools may modify only the current browser workspace.","mcp_transport":"The JSON MCP Server Card advertises same-origin /mcp by default. The webapp proxy forwards to server-only DATASET_MCP_QUERY_API_URL; DATASET_MCP_PUBLIC_ENDPOINT is an optional server-only public endpoint override and internal origins are not exposed."}}