Download URL to project upload - Veryfront

Download bytes from an HTTP(S) URL and store them as a project upload. Use this for integration resource URLs or signed attachment URLs instead of returning file bytes through tool results.

Tool details

Field	Value
Name	`download_url_to_project_upload`
Group	Uploads

Playground

Input schema

input-schema.json

{
  "type": "object",
  "properties": {
    "project_reference": {
      "type": "string",
      "description": "Project ID or slug"
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "HTTP(S) URL to download. Use signed/provider URLs when authorization is needed."
    },
    "file_path": {
      "type": "string",
      "description": "Destination upload path (e.g., attachments/invoice.pdf). Must be URL-encoded if it contains special characters or spaces."
    },
    "headers": {
      "type": "object",
      "additionalProperties": {
        "type": "string",
        "description": "Additional structured values supplied to the tool."
      },
      "description": "Optional request headers, for example Authorization for signed/provider download endpoints. Hop-by-hop headers are rejected."
    },
    "content_type": {
      "type": "string",
      "description": "Override MIME type. Defaults to the response Content-Type header or application/octet-stream."
    },
    "expected_size": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Optional exact byte size guard. The tool fails if downloaded bytes do not match."
    },
    "max_bytes": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 536870912,
      "description": "Optional download size limit in bytes. Defaults to 104857600 and is capped at 536870912."
    }
  },
  "required": [
    "url",
    "file_path"
  ],
  "additionalProperties": false,
  "description": "Input schema for the download_url_to_project_upload tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

output-schema.json

{
  "type": "object",
  "properties": {
    "upload_id": {
      "type": "string",
      "description": "The upload id associated with this record."
    },
    "file_path": {
      "type": "string",
      "description": "The file path associated with this record."
    },
    "path": {
      "type": "string",
      "description": "The path associated with this record."
    },
    "file_name": {
      "type": "string",
      "description": "The file name associated with this record."
    },
    "content_type": {
      "type": "string",
      "description": "The content type associated with this record."
    },
    "size": {
      "type": "number",
      "description": "The size associated with this record."
    },
    "status": {
      "type": "string",
      "description": "Lifecycle status for the record."
    }
  },
  "required": [
    "upload_id",
    "file_path",
    "path",
    "file_name",
    "content_type",
    "size",
    "status"
  ],
  "additionalProperties": false,
  "description": "Structured download url to project upload output schema for MCP tools.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}