Prepare a source upload

Get a URL to send a source ZIP (up to 100 MiB) to: PUT the bytes to directUpload.url with directUpload.headers, then call completeSourceUpload. MCP cannot carry file bytes, so use an HTTP client for that step. uploadSourceArchive is the alternative that sends the bytes through the HCode API with your credential.

Tool: createSourceUpload
Permission: source:write
Kind: Makes changes

Arguments

Name	Type	Required	Limits
`filename`	`string`	Yes	At least 1 character(s)
`sizeBytes`	`integer`	Yes	Minimum 1
`contentType`	`string`	No	See schema
`projectId`	`string`	No	At least 1 character(s)

Full input schema

{
  "type": "object",
  "properties": {
    "filename": {
      "type": "string",
      "minLength": 1
    },
    "sizeBytes": {
      "type": "integer",
      "minimum": 1
    },
    "contentType": {
      "type": "string"
    },
    "projectId": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "filename",
    "sizeBytes"
  ],
  "additionalProperties": false
}

Example call

The params of a tools/call request. Replace the placeholder values with your own IDs.

{
  "name": "createSourceUpload",
  "arguments": {
    "filename": "source.zip",
    "sizeBytes": 1048576
  }
}

Result

The same data as the API operation, wrapped as {"untrusted_data": true, "source": "createSourceUpload", "note": "...", "data": ...} so the model treats project content as data, not instructions.