download_dataset

Issue a clickable CSV download URL that points at the MCP server’s download proxy. The S3 bucket and object key are never exposed.

When to use it

When the user explicitly asks for the file (“send me the CSV”, “download the results”, “export this”, “give me the spreadsheet”). Surface the returned download_url directly in the chat reply — that link is the deliverable.

Inputs

Parameter	Type	Required	Description
dataset_id	string	Yes	The ds_... identifier returned by a previous tool.
expires_in_seconds	integer	No	Override for the URL TTL. Server-clamped: min 60 s, default 1 h, max 24 h.
target_tenant_id	string	No	Super tenants only.

Returns

{
  "download_url": "https://mcp.onfire.ai/download/...",
  "expires_at": "2026-05-18T15:00:00Z",
  "file_name": "dataset.csv",
  "mime_type": "text/csv",
  "row_count": 1240,
  "columns": ["..."]
}

Notes

• The URL is unauthenticated once issued — anyone who receives it can download until it expires. Treat it as sensitive.
• TTL is clamped server-side; you cannot extend a link beyond 24 hours.