MCP server

Gdex

io.github.rpconroy/gdex-mcp

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

MCP server for the GDEX (Geoscience Data Exchange) data portal: datasets, files, metrics, subsetting

Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

30

Token cost

About 7,014 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http gdex-mcp https://gdex-mcp.k8s.ucar.edu/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.gdex-mcp]
url = "https://gdex-mcp.k8s.ucar.edu/mcp"

Gemini CLI

{"mcpServers":{"gdex-mcp":{"httpUrl":"https://gdex-mcp.k8s.ucar.edu/mcp"}}}

Cursor

{"mcpServers":{"gdex-mcp":{"url":"https://gdex-mcp.k8s.ucar.edu/mcp"}}}

VS Code

{"servers":{"gdex-mcp":{"type":"http","url":"https://gdex-mcp.k8s.ucar.edu/mcp"}}}

Antigravity

agy mcp add gdex-mcp https://gdex-mcp.k8s.ucar.edu/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"gdex-mcp","server_url":"https://gdex-mcp.k8s.ucar.edu/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"gdex-mcp","server_url":"https://gdex-mcp.k8s.ucar.edu/mcp"}

Tools

• check_request_status ~94 tokens
  Check the status of a specific subsetting request. Requires GDEX_TOKEN. Args: rindex: Request index/ID
• describe_dataset ~185 tokens
  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 fail
• find_dataset_files ~563 tokens
  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 gin
• get_arco_variables ~349 tokens
  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 th
• get_control_file_template ~102 tokens
  Return the control file template for building a subsetting request for a dataset. Args: dsid: Dataset ID (dNNNNNN), e.g. d083002
• get_data_access ~98 tokens
  Return data access options for a dataset — download links, Globus URLs, access methods. Args: dsid: Dataset ID (dNNNNNN), e.g. d083002
• get_dataset_field ~254 tokens
  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_d
• get_dataset_files ~554 tokens
  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
• get_dataset_metadata ~103 tokens
  Return full metadata for a GDEX dataset (parameters, temporal range, spatial coverage, etc.). Args: dsid: Dataset ID (dNNNNNN), e.g. d083002
• get_dataset_metrics ~125 tokens
  Return a per-dataset metric. Args: dsid: Dataset ID (dNNNNNN), e.g. d083002 metric: One of: users_month, users_year, volume_month, volume_year
• get_file_groups ~462 tokens
  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 fr
• get_filesearch_cyclone_fix_files ~238 tokens
  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
• get_filesearch_cyclone_fix_filters ~208 tokens
  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/befo
• get_filesearch_datatypes ~156 tokens
  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 (d
• get_filesearch_grid_files ~447 tokens
  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 fir
• get_filesearch_grid_filters ~410 tokens
  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
• get_filesearch_result_page ~224 tokens
  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),
• get_filesearch_sensor_files ~224 tokens
  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: Restric
• get_filesearch_sensor_filters ~193 tokens
  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"
• get_portal_metrics ~119 tokens
  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
• get_request_files ~94 tokens
  Return the output files for a completed subsetting request. Requires GDEX_TOKEN. Args: rindex: Request index/ID
• get_staff ~93 tokens
  Return GDEX staff contacts, optionally filtered to a specific dataset. Args: dsid: Optional dataset ID. If omitted, returns all staff.
• has_arco ~284 tokens
  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 whol
• list_datasets ~256 tokens
  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
• list_request_statuses ~64 tokens
  List all subsetting request statuses for the authenticated user. Requires GDEX_TOKEN.
• purge_request Deletes data · ~92 tokens
  Delete a subsetting request and its output files. Requires GDEX_TOKEN. Args: rindex: Request index/ID to purge
• search_arco_variables ~266 tokens
  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={"remo
• submit_and_wait_for_request ~410 tokens
  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"
• submit_subset_request ~156 tokens
  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
• validate_subset_request ~191 tokens
  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. d08

Browse

• GitHub tools
• GitHub and code hosting

Related MCP servers

• Dantes Exchange
  Paid trader skills MCP. Coil scanner with dated 252d forward-return evidence. x402 USDC.
• Datagov Au
  data.gov.au MCP — Australia open-data CKAN catalogue.
• Dados Pt
  dados.gov.pt MCP — Portugal's national open data portal.
• Opendatasoft
  Opendatasoft (generic portal) MCP.
• SQD
  Query 130+ SQD Portal datasets across blockchains, including native Tron transactions and events.
• Datagov Uk
  data.gov.uk MCP — UK national open-data portal (CKAN API).
• Socrata
  Search and query government open-data portals (Socrata SODA API).
• Probative legal-marketing data
  US lawyer ad rules, bar ad filing, ethics opinions, ad-platform policies, fee caps, MDLs. CC BY 4.0.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.rpconroy/gdex-mcp.svg)](https://aptlynx.net/servers/io.github.rpconroy/gdex-mcp)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents