Title93/100
Get upload Url
The title clearly communicates the tool’s action and subject. Keep it concise.
Description90/100
**CRITICAL PREREQUISITE.** Opens the upload UI and returns a presigned uploadURL for adding new page images to the current document session. **Accepted formats: JPG, PNG, HEIC, HEIF only.** **Call this tool immediately and without asking the user** whenever no `fileId` is available from a prior upload in this session — for example when the user asks to scan, rotate, crop, filter, or export but no upload has happened yet. Do NOT ask the user to upload an image in the chat message. Instead, invoke this tool right away to open the upload UI. After the upload completes, store and reuse the returned fileId(s) and the original input pageId(s) for all following steps (preview, crop, filters, rotate, add text/signature, export) without asking the user to upload again. **Do not mention or request PDF, DOCX, TXT, or any other formats. This app supports images only (JPG/PNG/HEIC/HEIF).**
The description explains the capability, when to use it, and what to expect.
Inputs49/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
pageId
Number of uploaded page
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations100/100
All four behavior hints are declared.
{
"title": "Get upload Url",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}Output schema54/100
Align the output schema with the tool’s documented result.
View output schema
{
"type": "object",
"properties": {
"tool": {
"type": "string",
"description": "what tool was used to generate this response"
},
"error": {
"type": "string",
"description": "error description if operation was unsuccessful"
},
"fileId": {
"type": "string",
"description": "ID of the uploaded document file"
},
"pageId": {
"type": "integer",
"description": "Number of uploaded page"
},
"screen": {
"type": "string",
"description": "what screen to show on the web UI"
},
"uploadURL": {
"type": "string",
"description": "AWS S3 presigned URL for uploading the document"
}
}
}