Download Results
download_resultsFetch and save exports for Suparse document IDs directly to your local disk. Supports CSV, XLSX, Google Sheets, and JSON formats.
Instructions
Fetch an export for one or more Suparse document IDs and write it directly to local disk. Use this for CSV, XLSX, Google Sheets, and saved JSON files. Do not call fetch_json_results unless you intentionally need full JSON in the MCP response. If output_path is a directory, the API-provided filename is used inside that directory. If cleanup is needed, call delete_documents after this tool succeeds.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| format | Yes | Export format to write to local disk. Use this tool for csv and xlsx. | |
| api_url | No | Optional API base URL. Defaults to SUPARSE_API_URL or Suparse production API. | |
| export_type | No | Export mode for csv, xlsx, and google_sheets. Defaults to unified. | |
| output_path | No | Optional local output file path or existing directory. When omitted, writes to the current working directory using the API-provided or generated filename. | |
| document_ids | Yes | Suparse document IDs to export. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| format | Yes | ||
| export_type | Yes | ||
| output_path | Yes | ||
| document_ids | Yes |