Skip to main content

Registry of Open Data on AWS (RODA) MCP Server

Model Context Protocol (MCP) server for discovering and exploring datasets from the Registry of Open Data on AWS (RODA). The Registry hosts hundreds of publicly available datasets including climate data, genomics, satellite imagery, and more on Amazon Simple Storage Service (S3).

Features

  • Discover datasets across 1,000+ open datasets on AWS
  • Search by keyword, organization, license, or topic in natural language
  • Find related datasets and explore by domain
  • Always surfaces license information
  • Preview and sample datasets for early evaluation
  • Curated next steps on how to access datasets
  • For public datasets without controlled access:
    • preview S3 bucket structure
    • sample file directly in conversation

Basic Usage

Ask your AI assistants in natural language:

  • "What open data are on AWS?"
  • "Show me datasets related to land surface temperature."
  • "Get more details about 1000 Genomes."
  • "Preview the file structure of CHIRPS and sample a file."

For more example on how to use the MCP server, check out Example Usage.

Prerequisites

  1. Install uv from Astral
  2. Install Python 3.10+ using uv python install 3.10

Available Tools

Tool Description
search_datasets Search by keyword with optional filters for tags, organization, and license type
list_datasets List all datasets with optional tag filtering
get_dataset_details Get complete details for a specific dataset including resources and access info
discover_by_organization Find datasets managed by a specific organization (e.g., NASA, NOAA)
discover_by_license Find datasets by license type (e.g., Creative Commons, MIT)
find_related_datasets Find datasets related to a given dataset based on shared tags
get_knowledge_base_stats Get registry statistics including top tags, organizations, and resource types
preview_dataset Show S3 bucket structure for datasets (no download, no AWS account needed). This is only available for public datasets without controlled access. You should review and agree to the dataset license before previewing datasets.
sample_dataset Read the first 100KB of a specific file from a public dataset's S3 bucket. This is only available for public datasets without controlled access. You should review and agree to the dataset license before sampling datasets.
search_stac_endpoints Find datasets with STAC (SpatioTemporal Asset Catalog) API endpoints

Datasets on the Registry fall into three access tiers, due to different compliance reasons:

  • Open and free; hosted in a public S3 bucket and don't require AWS account to use
  • Open, but require AWS credentials and requester pay
  • Controlled access, particularly in health domains, and requires additional steps to access the datasets

For the datasets that are open and free, we offer a preview into S3 buckets, as well as capability to sample a file to help users quickly evaluate the datasets. For other datasets, we provide access instructions to users on how to access the datasets.

To learn more about how we designed this MCP server, check out High-Level Design.

Setup

Using uv

Configure the MCP server in your MCP client configuration (e.g., for Kiro, edit ~/.kiro/settings/mcp.json):

For Linux/MacOS users:

{
  "mcpServers": {
    "awslabs.roda-mcp-server": {
      "command": "uvx",
      "args": [
        "awslabs.roda-mcp-server@latest"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

For Windows users:

{
  "mcpServers": {
    "awslabs.roda-mcp-server": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "awslabs.roda-mcp-server@latest",
        "awslabs.roda-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Using Claude Code CLI

# Add RODA MCP
claude mcp add roda-mcp uvx awslabs.roda-mcp-server@latest

# List installed server
claude mcp list

Security

Check out Security for security considerations on this MCP server.

License

Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.

Licensed under the Apache License, Version 2.0 (the "License").

Disclaimer

This roda-mcp-server package is provided "as is" without warranty of any kind, express or implied, and is intended for development, testing, and evaluation purposes only. We do not provide any guarantee on the quality, performance, or reliability of this package. LLMs are non-deterministic and they make mistakes, we advise you to always thoroughly test and follow the best practices of your organization before using these tools on customer facing accounts. Users of this package are solely responsible for implementing proper security controls and MUST use AWS Identity and Access Management (IAM) to manage access to AWS resources. You are responsible for configuring appropriate IAM policies, roles, and permissions, and any security vulnerabilities resulting from improper IAM configuration are your sole responsibility. By using this package, you acknowledge that you have read and understood this disclaimer and agree to use the package at your own risk.

Metadata

Release files for awslabs.roda-mcp-server 0.1.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for awslabs.roda-mcp-server 0.1.7
File Size Uploaded
awslabs_roda_mcp_server-0.1.7.tar.gz 269.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for awslabs.roda-mcp-server 0.1.7
File Interpreter ABI Platform
awslabs_roda_mcp_server-0.1.7-py3-none-any.whl Python 3 none any Details

Total release size: 293.4 kB

Release files / awslabs_roda_mcp_server-0.1.7.tar.gz

Download URL awslabs_roda_mcp_server-0.1.7.tar.gz
Size 269.3 kB
Tags Source
SHA-256 checksum
How to use checksums
6afb05b9b0a4be1605119982d46a6cee2590677dcb8fd1d37a78038839236c6b
BLAKE2b-256 checksum
How to use checksums
8ff8b79bd533dc8da4288a317123b7060cf934f641043adf69b7a453c4ba9ac3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 22, 2026.

Transparency log

Release files / awslabs_roda_mcp_server-0.1.7-py3-none-any.whl

Download URL awslabs_roda_mcp_server-0.1.7-py3-none-any.whl
Size 24.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e57cd19b3fa74ff60320014a6e3eef9bceabdc9534e4dfb531df077bd9b32b3d
BLAKE2b-256 checksum
How to use checksums
2aa3faf5cc28f1a433b5fe10c6d99860f5203518a348a4d772087ab165a7ff5f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 22, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.7 This release

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page