assets_download_url MCP tool: a short-lived link for an uploaded asset
The hosted MCP tool assets_download_url returns a short-lived signed URL for a first-party asset. Use it only when asked, and never echo the URL in a report.
assets_download_url is the read tool in the hosted MCP Assets group that returns a short-lived download URL for an asset you uploaded to Sume. Use it only when the user asks to retrieve that file, and use the URL only for that download. Do not repeat a signed URL in a report or a log (MCP tools and gates).
The Assets tools in one table
Hosted MCP can not read files from your laptop. The upload flow is: create an upload URL, have the client PUT the bytes, then call assets_complete.
| Tool | Kind |
|---|---|
assets_list, assets_get | Read |
assets_download_url | Read |
assets_create, assets_upload_url, assets_complete | Write, with idempotency_key |
Rules for an agent
- Call
assets_getto check that an upload is finished. Useassets_download_urlonly if the user wants the file back. - Treat the signed URL like a password that expires. Keep it out of thread messages and tickets.
- Request a new URL when it expires, instead of saving the old one.
- For a generated file, read the output of the run, not this tool.
Sources
Related posts
More in Agents
- Captions drift after cutting pauses: burn them on the final render
Cut pauses first, then caption. Word times from the original clip no longer match once silence is gone. Run Sume video-captions on the trimmed render.
- Create a Sume schedule by API? Dashboard first, then trigger by API
The Sume API cannot create or edit schedules. Create it in the dashboard with a cron or an api trigger, then call it from code. What each trigger type means.
- Cut a video to 15 seconds for Reddit Engaged Video Views
Reddit began a 15-second Engaged Video Views beta in September. Cut any hosted clip to 15 seconds with Sume video-trim for a flat $0.02, exact or keyframe.
- Keyframe or exact video trim for pause cuts: read actual_start_seconds
Exact trim cuts where you say; keyframe trim is faster but snaps to a keyframe. For pause cuts that decides whether words get clipped. How to choose and check.
Written by Sume