Claude Code MCP images saved to file: Sume returns a media URL
Claude Code 2.1.283 saves images from MCP tools to a file. Sume tool results are text with a media.sume.com URL, so keep the URL as the durable reference.

Claude Code 2.1.283 (September 25) now also saves images returned by MCP tools to a file, so Bash and Read can open them. Sume's hosted MCP returns tool results as one text item holding JSON, and generated images in it are media.sume.com URLs, so the durable reference is the URL, not a local file.
Changelog line from Claude Code's docs; Sume behavior from Jobs and results and MCP tools and gates plus the MCP server source, all read 2026-10-01.
What does the Claude Code change do?
The changelog says images returned by MCP tools are now also saved to a file. It does not describe where the file goes or how long it lasts, so check your own session before building on a path.
What does a Sume image tool return?
In the server source I read, the success path builds one content item of type text containing the JSON result. A search of packages/mcp-server/src for image content blocks found none. The job result docs show artifacts with an id starting artf_, a url on media.sume.com, a type and a content_type. Whether Claude Code's new file save kicks in for a text result is not something either source says; I would not assume it does.
| Copy | Source of truth | Good for |
|---|---|---|
media.sume.com URL in the tool result | Sume job result | Reports, later tool calls, sharing |
| Local file saved by Claude Code | Claude Code changelog, 2.1.283 | Opening with Bash or Read on that machine |
assets_download_url | Sume MCP read tool | Fetching a download URL for an asset |
How should I report the image?
The playbook says to prefer Sume public ids and media.sume.com URLs in agent reports, and not to paste signed URLs, OAuth tokens or API keys into chat logs. If you need the bytes on disk, ask for a download with assets_download_url and fetch it yourself. Hosted MCP cannot read files from your laptop, so going the other direction needs the upload flow: create an upload URL, PUT the bytes, then assets_complete.
What should I do?
Keep the artf_ id and the URL from the result. Treat any local copy as a convenience. To choose a server for stills, see best MCP for image generation.
Sources
Related posts
More in Developers
- Claude Code /usage MCP server credit: reading Sume spend
Claude Code 2.1.286 credits an MCP server for calls made while it was still connecting. Sume spend is a separate number: read it with usage_get.
- Claude Managed Agents auto permission and Sume paid MCP calls
The auto policy evaluates each MCP tool call server-side. Sume has no paid scope, so pair auto with dry_run, max_spend_usd and a scope-limited session.
- Claude Opus 5.5 tool_choice any 400: steer Sume tools instead
Opus 5.5 returns 400 for tool_choice any or tool. Use auto, then steer to generate_image with instructions and tools_schema, and keep dry_run before paid calls.
- Codex MCP input schema budget: how many Sume tools you load
Codex 0.158.0 makes MCP and Code Mode input schema budgets configurable. Sume keeps tool descriptions short and shows fewer tools to a read-only session.
Written by Sume