download_dataset
download_dataset returns a link the user can click to download a dataset
as CSV. The URL points at the MCP server’s own download proxy — the bucket
and object key are never exposed.
Use it when the user explicitly asks for the file (“send me the CSV”, “download the results”).
Inputs
Section titled “Inputs”| Parameter | Type | Required | Description |
|---|---|---|---|
dataset_id | string | Yes | The ds_... identifier returned by a previous tool. |
expires_in_seconds | integer | No | URL TTL. Default 1 hour; clamped to a minimum of 60s and a maximum of 24 hours. |
target_tenant_id | string | No | Super tenants only. |
Returns
Section titled “Returns”JSON with download_url, expires_at, file_name, mime_type,
row_count, and columns.
Notes & limits
Section titled “Notes & limits”- The link is unauthenticated once issued — anyone who receives it can download until it expires. Treat it as sensitive.
- The dataset itself still expires on the 7-day bucket lifecycle.