MCP proposes an experimental extension for file uploads and downloads
The MCP blog describes an optional extension that moves files between clients and tools without the model touching them. It is experimental and open for feedback.
what changed
On 10 November 2026 the MCP blog introduced an experimental extension, io.modelcontextprotocol/files, for protocol revision 2026-07-28 and later. A working group wrote it after repeated requests to save files to cloud storage or pull them into code sandboxes.
For uploads, a server marks a file argument with x-mcp-file in the tool schema. The client fills it in, so the model never handles the file. The host asks the user for approval first. Small files can go inline as base64, within a limit the server sets. Larger files use a separate upload over HTTPS, and the tool call is retried with a requestState value.
For downloads, the tool result carries the file details in _meta. The client fetches the file over HTTPS and checks the size, and the SHA-256 digest if one is given.
Each transfer target says whether the client may send its MCP credentials. Clients must refuse redirects. The post says a matching digest proves integrity, not safety.
The extension is optional and has no reference implementation yet. The authors expect to stabilize it before the end of 2026.
why it matters
Today teams pass files through MCP tools as large text blobs, or build their own side channel. This design keeps file bytes away from the model and puts approval and credential rules in the protocol. It will matter most to teams that run their own MCP servers or clients.
The design can change. The post lists open questions, including whether hosts must allowlist where files may go.
what we would do
- Read the draft now if you run an MCP server that handles files, and send feedback while it can still change.
- Do not build production code on it yet.
- Plan to treat every downloaded file as untrusted, even when the digest matches.
- Plan an origin allowlist on your host for upload targets that carry no MCP credentials.
sources
- Exploring File Uploads and Downloads in MCP (Model Context Protocol)
Drafted with Claude from the linked sources, reviewed by us.