---
title: "corestack_transfer_download_create"
url: https://docs.corefinity.com/mcp/tools/corestack_transfer_download_create
type: tool
last_updated: 2026-11-13
feature: files-and-transfers
related:
  - https://docs.corefinity.com/mcp/files-and-transfers.md
---
# corestack_transfer_download_create

**Prepare a download.** Pack a directory of the environment (or one file) into a download: tar.zst by default, tar.gz, or raw for a single file. Answers a task; once ready, the result (or corestack_transfer_get) carries a signed download_url valid for an hour, and the object is deleted after 24 hours. Files leave exactly as they are on disk. Scope: read. Long-running: answers with a task.

- Scope: `read`
- Runs as a task: yes

## When to use it

Pack a directory of the environment (or one file) into a download: tar.zst by default, tar.gz, or raw for a single file. Answers a task; once ready, the result (or corestack_transfer_get) carries a signed download_url valid for an hour, and the object is deleted after 24 hours. Files leave exactly as they are on disk.

## Inputs

- `site_id` (integer, ≥ 1, required)
- `path` (string, up to 1024 characters): Relative to the site root, or absolute under it. Default htdocs.
- `format` (one of `tar.zst`, `tar.gz`, `raw`, default `"tar.zst"`)
- `excludes` (array of string, up to 1024 characters, up to 100 items)

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "excludes": {
      "items": {
        "maxLength": 1024,
        "type": "string"
      },
      "maxItems": 100,
      "type": "array"
    },
    "format": {
      "default": "tar.zst",
      "enum": [
        "tar.zst",
        "tar.gz",
        "raw"
      ],
      "type": "string"
    },
    "path": {
      "description": "Relative to the site root, or absolute under it. Default htdocs.",
      "maxLength": 1024,
      "type": "string"
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id"
  ],
  "type": "object"
}
```

## Refusals

- `quota_exceeded`: an upload over `mcp.transfers.max_object_bytes`, or over the company's or the row's live-transfer quota; split the upload, or wait for older transfers to expire.
- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_transfer_download_create",
  "arguments": {
    "site_id": 4211
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_transfer_download_create with site_id 4211. (Prepare a download.) Tell me what it returned.
```

## The same task elsewhere

- Guide: [Files and transfers](https://docs.corefinity.com/mcp/files-and-transfers.md)
