Upload From Device
open_upload_widgetOpens an upload box so users can add photos, videos, or documents from their phone or computer when files lack a public URL, then returns public media URLs for posting.
Instructions
Let the user add photos, videos or documents from their phone or computer. Use it when the user wants to post a file that has no public URL, such as a photo on their phone, a file attached in the chat that upload_media cannot read (in ChatGPT, pass attached files to upload_media as attachments instead), or a file you built in a sandbox whose network blocks the get_upload_urls uploadUrl. Never suggest putting the files in a public GitHub repo or a file-sharing link instead. In apps that show MCP Apps widgets, such as ChatGPT and Claude chat, it shows an upload box in the chat, and when the upload finishes the box sends a message listing the public media URLs. In apps that cannot show the box, such as Claude Cowork and Claude Code, it returns status upload_link with uploadUrl, a page the user opens in their browser to upload, and uploadId: give the user the link, wait until they say they finished, then call this tool again with that uploadId to get the media URLs. Pass the media URLs as mediaUrls to create_post, update_post or bulk_schedule_posts. Nothing is uploaded until the user picks files. Accepts JPEG, PNG, WebP, GIF, MP4, QuickTime, PDF, PPT, PPTX, DOC and DOCX, up to 250 MB per file, 50 MB per image and 100 MB per document. Uploaded files are stored at public URLs.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "open_upload_widget"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uploadId | No | uploadId from an earlier call that returned an upload link. Returns the files the user uploaded through that link instead of opening a new upload. | |
| workspaceId | No | Workspace to act in: an id from list_workspaces. Omit to act in the workspace list_workspaces marks current. Use the same workspaceId for every call about the same workspace, since ids from one workspace (accounts, posts, uploads) do not exist in another |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | Without uploadId: status waiting_for_upload when the upload box is shown (the media URLs arrive later in a message from the box), or status upload_link with uploadUrl, uploadId and acceptsUntil. With uploadId: status (waiting, saving, ready, failed or expired), files ({ fileName, publicUrl } each), mediaUrls, failed ({ fileName, error } each), savingCount and acceptsUntil. |