List CKAN Dataset Resources
ckan_list_resourcesAssess dataset resources by listing format, size, DataStore availability, and download URL, optionally probing source portals for DataStore status.
Instructions
List all resources in a dataset with a compact summary.
Returns a focused table of resources showing format, size, DataStore availability, and download URL. Use this to quickly assess what files a dataset contains before deciding how to access the data.
Args:
server_url (string): Base URL of CKAN server
id (string): Dataset ID or name
format_filter (string): Filter resources by format, case-insensitive (e.g., "CSV", "json", "XLSX")
response_format ('markdown' | 'json'): Output format
Returns: Compact resource summary with name, ID, format, size, DataStore flag, and URL
Examples:
{ server_url: "https://dati.gov.it/opendata", id: "dataset-name" }
{ server_url: "...", id: "dataset-name", format_filter: "CSV" }
Typical workflow: ckan_package_search → ckan_list_resources (assess available files) → ckan_datastore_search (for resources with DataStore=true)
When a resource has DataStore=false but its download URL belongs to a different (source) portal, the tool can probe the source portal for DataStore availability and report source_datastore_active and source_portal_url so you can query the data there instead. This probing is OFF by default (it issues extra HTTP requests to hosts taken from the dataset's own resource URLs); set check_source_portal=true to enable it.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Dataset ID or name | |
| server_url | Yes | Base URL of the CKAN server | |
| format_filter | No | Filter resources by format, case-insensitive (e.g., 'CSV', 'json', 'XLSX') | |
| response_format | No | Output format: 'markdown' for human-readable or 'json' for machine-readable | markdown |
| check_source_portal | No | Opt-in (default false): when true, probes the source portal for DataStore availability when a resource URL points to a different CKAN instance. Issues extra HTTP requests to hosts taken from the dataset's resource URLs. |