# 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.

- Category: Backends and databases · by Hayden Bleasel
- Website: https://files-sdk.dev/
- Live data: no
- Checked on the official pages: 2026-10-24

## API

- No official API. Do not scrape the site; use it by hand or through its downloads.

## Price and code

- Free tier: Free open-source npm package (MIT); you pay only your own storage provider
- Open source: https://github.com/haydenbleasel/files-sdk

## Data and license

- License: MIT (https://github.com/haydenbleasel/files-sdk/blob/main/LICENSE); covers The library source and npm package; storage costs and terms are those of the backend you connect
- Commercial use OK
- Credit: not stated
- Embedding unclear
- Quote (api_official): "A unified storage SDK for object and blob backends." (https://files-sdk.dev/)
- Quote (commercial): "Open source, MIT licensed, and built on web standards." (https://files-sdk.dev/)
- Quote (license): "© 2026 Hayden Bleasel MIT License" (https://files-sdk.dev/)
- Quote (free_tier): "Open source, MIT licensed, and built on web standards." (https://files-sdk.dev/)
- Quote (install): "Install with `npm i files-sdk`, construct `new Files({ adapter: r2({ bucket }) })`, and call `upload`, `download`, `list`, `url`, and the rest." (https://files-sdk.dev/llms.txt)
- Quote (mcp): "`files ... mcp` boots a read-only [MCP server](https://modelcontextprotocol.io) on stdio." (https://files-sdk.dev/docs/cli/mcp)
- Quote (mcp_writes): "Pass `--allow-writes` to also expose mutating tools: `upload`, `delete`, `copy`, `move`, and `sign-upload`." (https://files-sdk.dev/docs/cli/mcp)

## Rules for an agent

- 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

## Agent access

- llms.txt: https://files-sdk.dev/llms.txt
- MCP: files ... mcp (built-in stdio MCP server in the files CLI from the files-sdk package)

Human page: https://agentgid.com/resources/files-sdk/
Source: AgentGid (agentgid.com). Facts are quoted from the site's own pages; check the license page before you ship.