Backends and databases · by Hayden Bleasel
Files SDK
An MIT-licensed TypeScript library (npm i files-sdk) that gives one set of methods (upload, download, list, search, signed URLs and more) over 48 storage backends such as S3, R2, GCS, Azure Blob, Vercel Blob and Supabase, with plugins for encryption or versioning, React/Vue/Svelte upload UI, a CLI and a read-only MCP server.
You can switch your app from S3 to R2 or Vercel Blob by changing one adapter line instead of rewriting every upload and signed-URL call.
Open sourceFree tierCommercial OKFor your project
- Official API
- No official API
“A unified storage SDK for object and blob backends.” files-sdk.dev/
- Data download
- Not stated
- Price
- Free tier Free open-source npm package (MIT); you pay only your own storage provider
“Open source, MIT licensed, and built on web standards.” files-sdk.dev/
- Open source
- haydenbleasel/files-sdk
- License
- MIT The library source and npm package; storage costs and terms are those of the backend you connect
- Commercial use
- Commercial use OK
“Open source, MIT licensed, and built on web standards.” files-sdk.dev/
- Credit
- Not stated
- Embedding
- Embedding unclear
- Using the website
- Free
Read on Files SDK's own pages on Oct 24, 2026 · license or terms · API docs · source code. Check the license page before you ship.
For your agent
No official API. An agent should not scrape the site: use it by hand.
- npm i files-sdk; import { Files } from 'files-sdk' and an adapter from its subpath (files-sdk/s3, files-sdk/r2, ...); provider credentials come from your own storage account; the files CLI's MCP server is read-only unless started with --allow-writes; an agent skill is at https://files-sdk.dev/.well-known/agent-skills/files-sdk.tar.gz
- Keep the MIT license notice when you copy or redistribute the library
- Start the MCP server without --allow-writes unless the agent really needs to change files
llms.txt: files-sdk.dev/llms.txt · MCP: files ... mcp (built-in stdio MCP server in the files CLI from the files-sdk package)
Paste into your agent: Read https://agentgid.com/resources/files-sdk/agent.md before using Files SDK.
Quick answers
Does Files SDK have an API?
We found no official API for Files SDK. Use the site by hand; do not scrape it.
Is Files SDK free?
Yes, there is a free tier: Free open-source npm package (MIT); you pay only your own storage provider
Can I use Files SDK in a commercial project?
Yes. Its terms say: "Open source, MIT licensed, and built on web standards."
What you can build
- A storage layer that keeps uploads on local disk in development and R2 in production with the same code
- A migration script that copies a bucket from S3 to another provider with the transfer and sync operations
- Give Claude Code read-only access to one bucket through the built-in MCP server to search and read files
Alternatives in Backends and databases
Something wrong or out of date? Tell us.