MCP-Server
gdex-mcp
io.github.rpconroy/gdex-mcp
Was dieses MCP kann
Searches and describes geoscience datasets in GDEX, including metadata, files, variables, access methods, metrics and authenticated data subsetting.
Funktionen
Tools
30
Tools
check_request_status
Check the status of a specific subsetting request. Requires GDEX_TOKEN.
Args:
rindex: Request index/ID
Eingabeschema
{'type': 'object', 'title': 'check_request_statusArguments', 'required': ['rindex'], 'properties': {'rindex': {'type': 'string', 'title': 'Rindex'}}}
Ausgabeschema
{'type': 'object', 'title': 'check_request_statusOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
describe_dataset
Return a combined overview of a dataset â abstract, temporal coverage,
spatial coverage, variables, data formats, and volume â in a single call.
Prefer this over calling get_dataset_field repeatedly when the user wants
a general summary of a dataset. If one of the underlying fields fails to
load, it's returned as {"error": ...} rather than failing the whole call.
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
Eingabeschema
{'type': 'object', 'title': 'describe_datasetArguments', 'required': ['dsid'], 'properties': {'dsid': {'type': 'string', 'title': 'Dsid'}}}
Ausgabeschema
{'type': 'object', 'title': 'describe_datasetOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
find_dataset_files
Search a dataset's file-group hierarchy for files matching a name
pattern (e.g. a date like "20220808"), without ever pulling a large,
context-blowing file listing.
Automates the pattern described in get_file_groups: recursively calls
get_file_groups, descending into every child gindex, until a gindex
returns no further children (a leaf group) â then calls get_dataset_files
there with filter_wfile=name_pattern and keeps only the matches. Prefer
this over manually drilling with get_file_groups/get_dataset_files when
you don't already know roughly where in the hierarchy to look.
A dataset's hierarchy can be large (hundreds of leaf groups), and this
tool has no way to know in advance which branches might contain a match,
so it may need to visit many groups to be thorough. Pass start_gindex if
you already know a good starting point (e.g. from a prior get_file_groups
call, or a related dataset's structure) to narrow and speed up the
search. If the number of groups visited hits max_groups_visited, the
search stops early and `stopped_early` comes back true â narrow with
start_gindex and retry, or raise the cap.
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
name_pattern: Filename substring/pattern to match, e.g. "20220808" for a date
start_gindex: Optional group index to start the search from, instead of the dataset root
max_groups_visited: Safety cap on groups traversed before giving up (default 300)
Eingabeschema
{'type': 'object', 'title': 'find_dataset_filesArguments', 'required': ['dsid', 'name_pattern'], 'properties': {'dsid': {'type': 'string', 'title': 'Dsid'}, 'name_pattern': {'type': 'string', 'title': 'Name Pattern'}, 'start_gindex': {'type': 'string', 'title': 'Start Gindex', 'default': ''}, 'max_groups_visited': {'type': 'integer', 'title': 'Max Groups Visited', 'default': 300}}}
Ausgabeschema
{'type': 'object', 'title': 'find_dataset_filesOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_arco_variables
Return the list of ARCO variables available for a dataset.
Each row's type (index 2) is either "zarr" or "reference" (kerchunk).
A "reference" variable is often listed multiple times, once per kerchunk
reference variant (plain, "-remote-https", "-remote-osdf", etc.) â always
pick the "-osdf" variant's URL; the others' chunk targets can be internal
paths that only resolve on NCAR's network. Open it with
xr.open_dataset(url, engine="kerchunk", storage_options={"remote_protocol":
"https", "lazy": True}) â that's better behaved than hand-building an
fsspec reference filesystem. A "zarr" row needs no variant picking â its
URL already routes through the OSDF director (rewritten automatically);
open it directly with xr.open_dataset(url, engine="zarr").
Results are capped at 300 rows (look for "truncated": true); narrow with
search_arco_variables if you hit the cap.
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
Eingabeschema
{'type': 'object', 'title': 'get_arco_variablesArguments', 'required': ['dsid'], 'properties': {'dsid': {'type': 'string', 'title': 'Dsid'}}}
Ausgabeschema
{'type': 'object', 'title': 'get_arco_variablesOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_control_file_template
Return the control file template for building a subsetting request for a dataset.
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
Eingabeschema
{'type': 'object', 'title': 'get_control_file_templateArguments', 'required': ['dsid'], 'properties': {'dsid': {'type': 'string', 'title': 'Dsid'}}}
Ausgabeschema
{'type': 'object', 'title': 'get_control_file_templateOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_data_access
Return data access options for a dataset â download links, Globus URLs, access methods.
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
Eingabeschema
{'type': 'object', 'title': 'get_data_accessArguments', 'required': ['dsid'], 'properties': {'dsid': {'type': 'string', 'title': 'Dsid'}}}
Ausgabeschema
{'type': 'object', 'title': 'get_data_accessOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_dataset_field
Return one metadata field for a dataset.
Prefer describe_dataset when the user wants a general summary covering
several of these at once (abstract, temporal, spatial_coverage,
variables, data_formats, volume) â this tool is for pulling a single
field, including the fields describe_dataset doesn't cover
(publications, contributors, related_datasets, documentation).
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
field: One of: abstract, variables, temporal, spatial_coverage,
publications, contributors, data_formats, volume,
related_datasets, documentation
Eingabeschema
{'type': 'object', 'title': 'get_dataset_fieldArguments', 'required': ['dsid', 'field'], 'properties': {'dsid': {'type': 'string', 'title': 'Dsid'}, 'field': {'type': 'string', 'title': 'Field'}}}
Ausgabeschema
{'type': 'object', 'title': 'get_dataset_fieldOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_dataset_files
Return a paginated file listing for a dataset or a specific group.
Depending on how deep gindex is in the group hierarchy, this returns
either actual file rows or another layer of subgroup summaries â there's
no way to tell in advance which you'll get. If you get subgroups, read
the gindex (or url) off a row and call again with that gindex to go one
level deeper; gindex values are dataset-specific and can't be guessed.
A shallow gindex on a large dataset can return a very large response
(thousands of files) â the file-row portion of the response is capped at
500 rows (look for "_truncated": true). Two ways to avoid hitting that
cap instead of drilling down group by group: pass filter_wfile with a
filename pattern (e.g. a date like "20220808") to filter down to matching
files, or page through a known group's results with `page`. filter_wfile
only filters actual file rows, so it has no effect at a gindex that's
still returning a subgroup summary rather than files â if a first attempt
comes back unfiltered, descend one level (see get_file_groups) and retry
there.
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
gindex: Optional group index to filter files
page: Page number to fetch (for a group with more files than fit on one page)
filter_wfile: Filter files by name pattern, e.g. "20220808" to match a date
fl: File list source (defaults to "web" server-side)
Eingabeschema
{'type': 'object', 'title': 'get_dataset_filesArguments', 'required': ['dsid'], 'properties': {'fl': {'type': 'string', 'title': 'Fl', 'default': ''}, 'dsid': {'type': 'string', 'title': 'Dsid'}, 'page': {'type': 'integer', 'title': 'Page', 'default': 0}, 'gindex': {'type': 'string', 'title': 'Gindex', 'default': ''}, 'filter_wfile': {'type': 'string', 'title': 'Filter Wfile', 'default': ''}}}
Ausgabeschema
{'type': 'object', 'title': 'get_dataset_filesOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_dataset_metadata
Return full metadata for a GDEX dataset (parameters, temporal range, spatial coverage, etc.).
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
Eingabeschema
{'type': 'object', 'title': 'get_dataset_metadataArguments', 'required': ['dsid'], 'properties': {'dsid': {'type': 'string', 'title': 'Dsid'}}}
Ausgabeschema
{'type': 'object', 'title': 'get_dataset_metadataOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_dataset_metrics
Return a per-dataset metric.
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
metric: One of: users_month, users_year, volume_month, volume_year
Eingabeschema
{'type': 'object', 'title': 'get_dataset_metricsArguments', 'required': ['dsid'], 'properties': {'dsid': {'type': 'string', 'title': 'Dsid'}, 'metric': {'type': 'string', 'title': 'Metric', 'default': 'volume_year'}}}
Ausgabeschema
{'type': 'object', 'title': 'get_dataset_metricsOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_file_groups
Return file groups for a dataset. Pass gindex to get child groups under a parent.
Groups nest (dataset -> format -> year -> month, or similar, varying by
dataset) and there's no way to predict a child's gindex in advance â each
group's gindex/url is dataset-specific and only knowable from the parent
response. To drill down, read the gindex (or url) off a row in this
response and pass that as the next call's gindex.
This never returns file rows, only groups â every response stays small
regardless of how many files the dataset holds, unlike get_dataset_files.
Descend until a call returns empty ({} or []): that means the gindex you
just called with is a leaf with no further subgroups, so it's safe to
call get_dataset_files there for the actual files. find_dataset_files
automates exactly this walk if you'd rather not do it by hand.
At the top level, watch for a "Kerchunk Reference Files" (or similar
ARCO-related) group alongside the raw-format groups. For an analysis
task, prefer pulling from there (see also has_arco/get_arco_variables)
over a raw data file when one's available â it avoids downloading a
whole file just to read a subset of it.
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
gindex: Optional group index to fetch child groups
Eingabeschema
{'type': 'object', 'title': 'get_file_groupsArguments', 'required': ['dsid'], 'properties': {'dsid': {'type': 'string', 'title': 'Dsid'}, 'gindex': {'type': 'string', 'title': 'Gindex', 'default': ''}}}
Ausgabeschema
{'type': 'object', 'title': 'get_file_groupsOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_filesearch_cyclone_fix_files
Search for data files containing "cyclone_fix" datatype data, optionally
filtered by time range. Results are paginated; use get_filesearch_result_page
with the returned result_id to fetch additional pages.
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
valid_datetime_min: Restrict to data valid on/after "YYYY-MM-DD HH:MM"
valid_datetime_max: Restrict to data valid on/before "YYYY-MM-DD HH:MM"
Eingabeschema
{'type': 'object', 'title': 'get_filesearch_cyclone_fix_filesArguments', 'required': ['dsid'], 'properties': {'dsid': {'type': 'string', 'title': 'Dsid'}, 'valid_datetime_max': {'type': 'string', 'title': 'Valid Datetime Max', 'default': ''}, 'valid_datetime_min': {'type': 'string', 'title': 'Valid Datetime Min', 'default': ''}}}
Ausgabeschema
{'type': 'object', 'title': 'get_filesearch_cyclone_fix_filesOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_filesearch_cyclone_fix_filters
Return the valid date range and other filters for "cyclone_fix"
datatype file search on a dataset.
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
valid_datetime_min: Restrict to data valid on/after "YYYY-MM-DD HH:MM"
valid_datetime_max: Restrict to data valid on/before "YYYY-MM-DD HH:MM"
Eingabeschema
{'type': 'object', 'title': 'get_filesearch_cyclone_fix_filtersArguments', 'required': ['dsid'], 'properties': {'dsid': {'type': 'string', 'title': 'Dsid'}, 'valid_datetime_max': {'type': 'string', 'title': 'Valid Datetime Max', 'default': ''}, 'valid_datetime_min': {'type': 'string', 'title': 'Valid Datetime Min', 'default': ''}}}
Ausgabeschema
{'type': 'object', 'title': 'get_filesearch_cyclone_fix_filtersOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_filesearch_datatypes
Return the file-search datatypes available for a dataset (a subset of
"grid", "cyclone_fix", "sensor"). Call this before the other filesearch_*
tools to know which one(s) apply â a dataset only supports search for the
datatypes it actually contains.
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
Eingabeschema
{'type': 'object', 'title': 'get_filesearch_datatypesArguments', 'required': ['dsid'], 'properties': {'dsid': {'type': 'string', 'title': 'Dsid'}}}
Ausgabeschema
{'type': 'object', 'title': 'get_filesearch_datatypesOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_filesearch_grid_files
Search for data files containing "grid" datatype data, filtered by
parameter code(s) and optionally by time range, product, grid, or level.
Results are paginated; use get_filesearch_result_page with the returned
result_id to fetch additional pages. Use get_filesearch_grid_filters
first to find valid parameter/product/grid/level codes for this dataset.
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
parameters: Parameter code(s) to search for (required, at least one)
valid_datetime_min: Restrict to data valid on/after "YYYY-MM-DD HH:MM"
valid_datetime_max: Restrict to data valid on/before "YYYY-MM-DD HH:MM"
products: Restrict to specified product code(s)
grids: Restrict to specified grid code(s)
levels: Restrict to specified vertical level code(s)
Eingabeschema
{'type': 'object', 'title': 'get_filesearch_grid_filesArguments', 'required': ['dsid', 'parameters'], 'properties': {'dsid': {'type': 'string', 'title': 'Dsid'}, 'grids': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Grids', 'default': []}, 'levels': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Levels', 'default': []}, 'products': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Products', 'default': []}, 'parameters': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Parameters'}, 'valid_datetime_max': {'type': 'string', 'title': 'Valid Datetime Max', 'default': ''}, 'valid_datetime_min': {'type': 'string', 'title': 'Valid Datetime Min', 'default': ''}}}
Ausgabeschema
{'type': 'object', 'title': 'get_filesearch_grid_filesOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_filesearch_grid_filters
Return the valid parameter/product/grid/level codes and date range for
"grid" datatype file search on a dataset. Use this to discover the codes
to pass to get_filesearch_grid_files, optionally narrowed by any filters
you already know you want.
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
valid_datetime_min: Restrict to data valid on/after "YYYY-MM-DD HH:MM"
valid_datetime_max: Restrict to data valid on/before "YYYY-MM-DD HH:MM"
parameters: Restrict to specified parameter code(s)
products: Restrict to specified product code(s)
grids: Restrict to specified grid code(s)
levels: Restrict to specified vertical level code(s)
Eingabeschema
{'type': 'object', 'title': 'get_filesearch_grid_filtersArguments', 'required': ['dsid'], 'properties': {'dsid': {'type': 'string', 'title': 'Dsid'}, 'grids': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Grids', 'default': []}, 'levels': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Levels', 'default': []}, 'products': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Products', 'default': []}, 'parameters': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Parameters', 'default': []}, 'valid_datetime_max': {'type': 'string', 'title': 'Valid Datetime Max', 'default': ''}, 'valid_datetime_min': {'type': 'string', 'title': 'Valid Datetime Min', 'default': ''}}}
Ausgabeschema
{'type': 'object', 'title': 'get_filesearch_grid_filtersOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_filesearch_result_page
Return a page of results from a previous get_filesearch_*_files call, by
its result_id. Use this to page through file-search results beyond the
first page (see the "pagination" block of a files/results response for
num_pages and next_page).
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
result_id: The result_id from a previous filesearch files/results response
page_num: Page number to retrieve
Eingabeschema
{'type': 'object', 'title': 'get_filesearch_result_pageArguments', 'required': ['dsid', 'result_id', 'page_num'], 'properties': {'dsid': {'type': 'string', 'title': 'Dsid'}, 'page_num': {'type': 'integer', 'title': 'Page Num'}, 'result_id': {'type': 'string', 'title': 'Result Id'}}}
Ausgabeschema
{'type': 'object', 'title': 'get_filesearch_result_pageOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_filesearch_sensor_files
Search for data files containing "sensor" datatype data, optionally
filtered by date range. Results are paginated; use get_filesearch_result_page
with the returned result_id to fetch additional pages.
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
valid_date_min: Restrict to data valid on/after "YYYY-MM-DD"
valid_date_max: Restrict to data valid on/before "YYYY-MM-DD"
Eingabeschema
{'type': 'object', 'title': 'get_filesearch_sensor_filesArguments', 'required': ['dsid'], 'properties': {'dsid': {'type': 'string', 'title': 'Dsid'}, 'valid_date_max': {'type': 'string', 'title': 'Valid Date Max', 'default': ''}, 'valid_date_min': {'type': 'string', 'title': 'Valid Date Min', 'default': ''}}}
Ausgabeschema
{'type': 'object', 'title': 'get_filesearch_sensor_filesOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_filesearch_sensor_filters
Return the valid date range and other filters for "sensor" datatype
file search on a dataset.
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
valid_date_min: Restrict to data valid on/after "YYYY-MM-DD"
valid_date_max: Restrict to data valid on/before "YYYY-MM-DD"
Eingabeschema
{'type': 'object', 'title': 'get_filesearch_sensor_filtersArguments', 'required': ['dsid'], 'properties': {'dsid': {'type': 'string', 'title': 'Dsid'}, 'valid_date_max': {'type': 'string', 'title': 'Valid Date Max', 'default': ''}, 'valid_date_min': {'type': 'string', 'title': 'Valid Date Min', 'default': ''}}}
Ausgabeschema
{'type': 'object', 'title': 'get_filesearch_sensor_filtersOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_portal_metrics
Return a GDEX portal-wide metric.
Args:
metric: One of: volume_downloaded, unique_users, total_datasets,
total_citations, gdex_volume, total_requests, top_datasets, ai_datasets
Eingabeschema
{'type': 'object', 'title': 'get_portal_metricsArguments', 'properties': {'metric': {'type': 'string', 'title': 'Metric', 'default': 'top_datasets'}}}
Ausgabeschema
{'type': 'object', 'title': 'get_portal_metricsOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_request_files
Return the output files for a completed subsetting request. Requires GDEX_TOKEN.
Args:
rindex: Request index/ID
Eingabeschema
{'type': 'object', 'title': 'get_request_filesArguments', 'required': ['rindex'], 'properties': {'rindex': {'type': 'string', 'title': 'Rindex'}}}
Ausgabeschema
{'type': 'object', 'title': 'get_request_filesOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_staff
Return GDEX staff contacts, optionally filtered to a specific dataset.
Args:
dsid: Optional dataset ID. If omitted, returns all staff.
Eingabeschema
{'type': 'object', 'title': 'get_staffArguments', 'properties': {'dsid': {'type': 'string', 'title': 'Dsid', 'default': ''}}}
Ausgabeschema
{'type': 'object', 'title': 'get_staffOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
has_arco
Check whether Analysis-Ready Cloud-Optimized (ARCO) data is available for a dataset.
For analysis tasks, call this (and check for a "Kerchunk Reference Files"
group via get_file_groups) before reaching for raw data files â reading
through ARCO/kerchunk references avoids downloading whole files just to
subset them. When picking among kerchunk reference variants, always use
the one with "-osdf" in its name (see get_arco_variables) â other
variants' chunk targets can be internal paths that only resolve on
NCAR's network. Open it with xr.open_dataset(url, engine="kerchunk",
storage_options={"remote_protocol": "https", "lazy": True}) rather than
hand-building an fsspec reference filesystem.
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
Eingabeschema
{'type': 'object', 'title': 'has_arcoArguments', 'required': ['dsid'], 'properties': {'dsid': {'type': 'string', 'title': 'Dsid'}}}
Ausgabeschema
{'type': 'object', 'title': 'has_arcoOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
list_datasets
List datasets available on GDEX, with their IDs and titles.
The full catalog has ~1700 datasets â far too many to return at once.
Always pass `query` to filter by keyword unless the user specifically
wants to browse the whole catalog page by page.
Args:
query: Keyword(s) to filter by, matched case-insensitively as a substring
against dataset id and title. Leave empty to browse unfiltered.
limit: Max number of datasets to return (default 50, capped at 500)
offset: Number of matching datasets to skip, for paging through results
Eingabeschema
{'type': 'object', 'title': 'list_datasetsArguments', 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 50}, 'query': {'type': 'string', 'title': 'Query', 'default': ''}, 'offset': {'type': 'integer', 'title': 'Offset', 'default': 0}}}
Ausgabeschema
{'type': 'object', 'title': 'list_datasetsOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
list_request_statuses
List all subsetting request statuses for the authenticated user. Requires GDEX_TOKEN.
Eingabeschema
{'type': 'object', 'title': 'list_request_statusesArguments', 'properties': {}}
Ausgabeschema
{'type': 'object', 'title': 'list_request_statusesOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
purge_request
Delete a subsetting request and its output files. Requires GDEX_TOKEN.
Args:
rindex: Request index/ID to purge
Eingabeschema
{'type': 'object', 'title': 'purge_requestArguments', 'required': ['rindex'], 'properties': {'rindex': {'type': 'string', 'title': 'Rindex'}}}
Ausgabeschema
{'type': 'object', 'title': 'purge_requestOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
search_arco_variables
Search ARCO variables by name for a dataset.
As with get_arco_variables, a "reference" (kerchunk) match is often
listed once per variant â always pick the "-osdf" variant's URL (reachable
from anywhere), and open it with xr.open_dataset(url, engine="kerchunk",
storage_options={"remote_protocol": "https", "lazy": True}). A "zarr"
match needs no variant picking â its URL already routes through the OSDF
director (rewritten automatically); open it directly with
xr.open_dataset(url, engine="zarr").
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
query: Search text to match against variable names
Eingabeschema
{'type': 'object', 'title': 'search_arco_variablesArguments', 'required': ['dsid', 'query'], 'properties': {'dsid': {'type': 'string', 'title': 'Dsid'}, 'query': {'type': 'string', 'title': 'Query'}}}
Ausgabeschema
{'type': 'object', 'title': 'search_arco_variablesOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
submit_and_wait_for_request
Submit a subset request and poll its status until it finishes, fails, or
timeout_s elapses â instead of calling submit_subset_request and then
manually looping on check_request_status. Requires GDEX_TOKEN.
GDEX's API schema doesn't document the exact status vocabulary, so
"finished" is a best-effort match on the status text (words like
"complete" vs. "error"/"fail"). If the outcome comes back "timeout", that
means the request is still pending by our reading, not that it failed â
keep polling with check_request_status(rindex), or re-run this tool with
a longer timeout_s. If it comes back "unknown", the status payload didn't
contain a field we recognize; inspect the raw "status" value yourself.
Args:
request_json: JSON string of the subsetting request body (see get_control_file_template).
poll_interval_s: Seconds between status checks (default 15, minimum 5).
timeout_s: Give up and return the last-seen status after this many seconds (default 600).
Eingabeschema
{'type': 'object', 'title': 'submit_and_wait_for_requestArguments', 'required': ['request_json'], 'properties': {'timeout_s': {'type': 'integer', 'title': 'Timeout S', 'default': 600}, 'request_json': {'type': 'string', 'title': 'Request Json'}, 'poll_interval_s': {'type': 'integer', 'title': 'Poll Interval S', 'default': 15}}}
Ausgabeschema
{'type': 'object', 'title': 'submit_and_wait_for_requestOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
submit_subset_request
Submit a data subset request to GDEX. Requires GDEX_TOKEN.
Args:
request_json: JSON string of the subsetting request body. Use get_control_file_template
to get the expected structure for a dataset, or validate_subset_request
to check it before submitting.
Eingabeschema
{'type': 'object', 'title': 'submit_subset_requestArguments', 'required': ['request_json'], 'properties': {'request_json': {'type': 'string', 'title': 'Request Json'}}}
Ausgabeschema
{'type': 'object', 'title': 'submit_subset_requestOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
validate_subset_request
Check a subset request body against the dataset's control file template,
without submitting anything. Use this before submit_subset_request to catch
missing or unrecognized fields fast, instead of finding out from a failed
API call.
Args:
dsid: Dataset ID (dNNNNNN), e.g. d083002
request_json: JSON string of the subsetting request body to validate
Eingabeschema
{'type': 'object', 'title': 'validate_subset_requestArguments', 'required': ['dsid', 'request_json'], 'properties': {'dsid': {'type': 'string', 'title': 'Dsid'}, 'request_json': {'type': 'string', 'title': 'Request Json'}}}
Ausgabeschema
{'type': 'object', 'title': 'validate_subset_requestOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
Verlauf
Letzte Tool-Änderungen
Hinzugefügt
purge_request
26. September 2026 02:40
Hinzugefügt
submit_and_wait_for_request
26. September 2026 02:40
Hinzugefügt
submit_subset_request
26. September 2026 02:40
Hinzugefügt
validate_subset_request
26. September 2026 02:40
Hinzugefügt
get_control_file_template
26. September 2026 02:40
Hinzugefügt
get_request_files
26. September 2026 02:40
Hinzugefügt
check_request_status
26. September 2026 02:40
Hinzugefügt
list_request_statuses
26. September 2026 02:40
Hinzugefügt
get_staff
26. September 2026 02:40
Hinzugefügt
get_dataset_metrics
26. September 2026 02:40
Hinzugefügt
get_portal_metrics
26. September 2026 02:40
Hinzugefügt
search_arco_variables
26. September 2026 02:40
Hinzugefügt
get_arco_variables
26. September 2026 02:40
Hinzugefügt
has_arco
26. September 2026 02:40
Hinzugefügt
get_data_access
26. September 2026 02:40
Hinzugefügt
get_filesearch_result_page
26. September 2026 02:40
Hinzugefügt
get_filesearch_sensor_files
26. September 2026 02:40
Hinzugefügt
get_filesearch_cyclone_fix_files
26. September 2026 02:40
Hinzugefügt
get_filesearch_grid_files
26. September 2026 02:40
Hinzugefügt
get_filesearch_sensor_filters
26. September 2026 02:40
Hinzugefügt
get_filesearch_cyclone_fix_filters
26. September 2026 02:40
Hinzugefügt
get_filesearch_grid_filters
26. September 2026 02:40
Hinzugefügt
get_filesearch_datatypes
26. September 2026 02:40
Hinzugefügt
find_dataset_files
26. September 2026 02:40
Hinzugefügt
get_dataset_files
26. September 2026 02:40
Hinzugefügt
get_file_groups
26. September 2026 02:40
Hinzugefügt
describe_dataset
26. September 2026 02:40
Hinzugefügt
get_dataset_field
26. September 2026 02:40
Hinzugefügt
get_dataset_metadata
26. September 2026 02:40
Hinzugefügt
list_datasets
26. September 2026 02:40
Entdecken
Ähnliche MCP-Server
Clink Forge
com.clinkforge/clink-forge
Provides pay-per-call access to attested government datasets, primarily CDC and HHS health data plus EPA air-quality observations.
osint
build.exascale/osint
Provides source-cited US data and schemas for power systems, AI infrastructure, semiconductor production and trade, robotics, and…
whatif
xyz.pflow.sim/whatif
Builds, validates, calibrates, compares, and simulates Petri-net process models using event logs, scenarios, invariants, and diag…
Us Iso Grid
io.github.pipeworx-io/us-iso-grid
Provides real-time and recent electricity grid data for CAISO, ERCOT, and NYISO, including demand, forecasts, fuel mix, emissions…
AOI — Environmental Intelligence for AI Agents
io.github.aminshojaeee1986-ui/aoi
Provides paid, quote-based environmental intelligence assessments covering climate risk, emissions, biodiversity, air quality, ha…
Pharma Intel
io.github.pipeworx-io/pharma-intel
Combines clinical trial, FDA, PubMed, drug identification, safety, pipeline, sales, patent, and pharmaceutical sponsor data for d…
Data Gov Sg
io.github.pipeworx-io/data-gov-sg
Provides Singapore government datasets and environmental feeds, including air quality, dataset metadata, and routed structured re…
Nih Reporter
io.github.pipeworx-io/nih-reporter
Searches and analyzes NIH-funded research projects, awards, publications, funding trends, expirations, investigators, organizatio…