National Map Product Search: Downloadable USGS Elevation, Boundary and Map Files (USGS)
usgstnm/search-products
Lists the downloadable products of one U.S. Geological Survey National Map dataset: title, format, extent, publication and update dates, file size in bytes, a metadata page and download links, plus the total number of matching products. Returns links and metadata only, never the files, which can be gigabytes. One page of up to 25 products per call, with an offset to read further. Filter by dataset, area (bounding box) and text. A filter that matches nothing returns zero products rather than an error. U.S. Geological Survey data, passed through unmodified and served by Eden Engine; not an official USGS product.
activeper callv1
Price
$0.0026 per call
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.
Data source
Source: U.S. Geological Survey (USGS), The National Map. USGS-authored data are in the U.S. public domain per usgs.gov/information-policies-and-instructions/copyrights-and-credits. Served by Eden Engine; not an official USGS product.
Use it
Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.
Connect once and your AI can find and run this tool, and any other it needs.
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "usgstnm/search-products" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "usgstnm/search-products" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "usgstnm/search-products", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "usgstnm/search-products", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.0026 |
- Updated
- Oct 20, 2026
Input and output schemas
Input schema
input_schema.json
{
"type": "object",
"required": [
"datasets"
],
"properties": {
"q": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Only products whose title or description match this text, for example \"Colorado\". Leave out for no text filter."
},
"max": {
"type": "integer",
"default": 5,
"maximum": 25,
"minimum": 1,
"description": "How many products to return, 1 to 25 (the cap is Omnial's own, to bound the response). Defaults to 5."
},
"bbox": {
"type": "string",
"pattern": "^-?[0-9]+(\\.[0-9]+)?(,-?[0-9]+(\\.[0-9]+)?){3}$",
"description": "Only products that cover this area: \"minLongitude,minLatitude,maxLongitude,maxLatitude\" in decimal degrees, no spaces, west and south negative, for example \"-105.3,39.9,-105.1,40.1\" (Boulder, Colorado). Leave out for the whole country. An area outside the United States returns zero products."
},
"offset": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "How many matching products to skip, for reading the next page: offset 5 with max 5 returns the second page of five. Leave out for the first page."
},
"datasets": {
"enum": [
"National Boundary Dataset (NBD)",
"National Elevation Dataset (NED) 1 arc-second",
"Digital Elevation Model (DEM) 1 meter",
"Seamless 1-m DEM (S1M)",
"National Elevation Dataset (NED) 1/3 arc-second",
"National Elevation Dataset (NED) 1/9 arc-second",
"National Elevation Dataset (NED) Alaska 2 arc-second",
"Alaska IFSAR 5 meter DEM",
"National Elevation Dataset (NED) 1/3 arc-second - Contours",
"Original Product Resolution (OPR) Digital Elevation Model (DEM)",
"Ifsar Digital Surface Model (DSM)",
"Ifsar Orthorectified Radar Image (ORI)",
"Lidar Point Cloud (LPC)",
"Historical Topographic Maps",
"National Hydrography Dataset Plus High Resolution (NHDPlus HR)",
"National Hydrography Dataset (NHD) Best Resolution",
"National Watershed Boundary Dataset (WBD)",
"Map Indices",
"National Geographic Names Information System (GNIS)",
"Small-scale Datasets - Boundaries",
"Small-scale Datasets - Contours",
"Small-scale Datasets - Hydrography",
"Small-scale Datasets - Transportation",
"National Structures Dataset (NSD)",
"Combined Vector",
"National Transportation Dataset (NTD)",
"US Topo Current",
"US Topo Historical",
"Land Cover - Woodland",
"3D Hydrography Program (3DHP)",
"US Topo",
"National Elevation Dataset (NED)",
"USDA National Agriculture Imagery Program (NAIP)",
"Geographic Names Domestic Names",
"Geographic Names Federal Codes",
"Geographic Names Full Model",
"Small-scale Datasets",
"Topobathymetric Lidar DEM",
"Topobathymetric Lidar Point Cloud"
],
"type": "string",
"description": "The National Map dataset to list products for, exactly as spelt, for example \"National Elevation Dataset (NED) 1/3 arc-second\" (usgstnm/list-datasets describes each one)."
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"required": [
"total",
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"body": {
"type": [
"string",
"null"
]
},
"urls": {
"type": [
"object",
"null"
],
"description": "Download links keyed by format label.",
"additionalProperties": {
"type": "string"
}
},
"title": {
"type": "string"
},
"extent": {
"type": [
"string",
"null"
],
"description": "For example National or a state."
},
"format": {
"type": [
"string",
"null"
]
},
"metaUrl": {
"type": [
"string",
"null"
],
"description": "Metadata page for the product."
},
"datasets": {
"type": "array"
},
"moreInfo": {
"type": [
"string",
"null"
]
},
"sourceId": {
"type": [
"string",
"null"
]
},
"sourceName": {
"type": [
"string",
"null"
]
},
"boundingBox": {
"type": [
"object",
"null"
],
"description": "minX, maxX, minY, maxY in decimal degrees.",
"additionalProperties": true
},
"dateCreated": {
"type": [
"string",
"null"
]
},
"downloadURL": {
"type": [
"string",
"null"
],
"description": "Default download link."
},
"lastUpdated": {
"type": [
"string",
"null"
],
"description": "Timestamp with its own UTC offset."
},
"sizeInBytes": {
"type": [
"integer",
"null"
],
"description": "Size of the download in bytes; can be gigabytes."
},
"bestFitIndex": {
"type": [
"number",
"null"
]
},
"processingUrl": {
"type": [
"string",
"null"
]
},
"vendorMetaUrl": {
"type": [
"string",
"null"
]
},
"downloadLazURL": {
"type": [
"string",
"null"
]
},
"publicationDate": {
"type": [
"string",
"null"
],
"description": "Plain date, YYYY-MM-DD."
},
"modificationInfo": {
"type": [
"string",
"null"
]
},
"downloadURLRaster": {
"type": [
"string",
"null"
]
},
"previewGraphicURL": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
},
"description": "The requested page of products. Empty when the dataset matches nothing."
},
"total": {
"type": "integer",
"description": "How many products match the dataset filter, not how many are in `items`."
},
"errors": {
"type": "array",
"description": "Errors the service reports; empty in every capture."
},
"messages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Service messages, for example how many items were retrieved."
},
"filteredOut": {
"type": "integer"
},
"sciencebaseQuery": {
"type": "string"
}
},
"description": "The National Map Access API products response, passed through as sent.",
"additionalProperties": true
}