Authorize a local reference upload
upload_referenceGet a free, short-lived upload grant for one local file using the existing APIXO MCP login. Choose the attachment route by capability. Use reference_files when the client provides native APIXO attachments, including ChatGPT and compatible Codex connectors. Otherwise, for user-selected files accessible to the client, automatically use upload_reference and the APIXO uploader when the client can run Node.js 22+ and reach APIXO. This applies to Claude Code, Cursor, Grok Bot, WorkBuddy, and other clients that meet those conditions. A request to use the selected files in APIXO is sufficient to start the upload; honor the client's execution permissions. Read the model schema and identify each destination URL field before uploading. Submit only confirmed URLs in the user's order. If file access or execution is unavailable, explain the limitation and ask for a usable direct link. Keep upload grants out of replies and show reference URLs only on request. Fetch the APIXO uploader from https://mcp.apixo.ai/tools/apixo-upload-reference.v1.mjs and save it locally as apixo-upload-reference.v1.mjs. Run node apixo-upload-reference.v1.mjs inspect with Node.js 22 or later to get the four tool arguments without sending the file. Pass the returned upload_id and grant as JSON on standard input to node apixo-upload-reference.v1.mjs upload . Keep the grant out of user-facing replies and the uploader's command-line arguments. Use the helper's confirmed url for generation. Upload links are public until temporary storage cleanup. If any required upload fails, stop before paid generation and report the issue.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"file_name": "<file_name>",
"content_type": "<content_type>",
"size_bytes": "<size_bytes>",
"request_id": "<request_id>"
},
"name": "upload_reference"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_name | Yes | ||
| request_id | Yes | Use the same UUID for retries of this file and its original metadata. | |
| size_bytes | Yes | ||
| content_type | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| grant | Yes | ||
| upload_id | Yes | ||
| helper_url | Yes | ||
| upload_url | Yes | ||
| grant_expires_at | Yes |