Box upload file

box__upload_file

Access

Requires a project integration connection for box.

Call type: Can change resources.

Arguments

FieldTypeRequiredDescription and constraints
fieldsstringNoComma-separated attribute list to include in the response
attributesobjectYesFile metadata sent as the multipart 'attributes' part (Box requires it to precede the file part), e.g. { "name": "report.pdf", "parent": { "id": "0" } }; the name must be unique within the parent folder
filestringYesBase64-encoded file content, sent decoded as the binary multipart 'file' part. The decoded file must not exceed 50 MB. Larger files require the chunked upload API, which this connector does not expose.
file_namestringYesFilename for the uploaded file part, e.g. report.pdf; should match the name in attributes

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "box__upload_file",
    "arguments": {
      "attributes": {
        "name": "example.txt",
        "parent": {
          "id": "0"
        }
      },
      "file": "SGVsbG8gQm94Cg==",
      "file_name": "example.txt"
    }
  }
}

Result

No output schema is published for this tool. The input contract does not define its return fields. Inspect the MCP response content and isError; do not assume a fixed object shape. See the box integration reference for provider setup and tool context.

Full schemas

json
{
  "type": "object",
  "properties": {
    "fields": {
      "type": "string",
      "description": "Comma-separated attribute list to include in the response"
    },
    "attributes": {
      "type": "object",
      "description": "File metadata sent as the multipart 'attributes' part (Box requires it to precede the file part), e.g. { \"name\": \"report.pdf\", \"parent\": { \"id\": \"0\" } }; the name must be unique within the parent folder"
    },
    "file": {
      "type": "string",
      "description": "Base64-encoded file content, sent decoded as the binary multipart 'file' part. The decoded file must not exceed 50 MB. Larger files require the chunked upload API, which this connector does not expose."
    },
    "file_name": {
      "type": "string",
      "description": "Filename for the uploaded file part, e.g. report.pdf; should match the name in attributes"
    }
  },
  "required": [
    "attributes",
    "file",
    "file_name"
  ],
  "description": "Arguments for the box__upload_file tool."
}