# file.rocks

> Storage API and MCP for agents. Prefer /docs/**/*.md twins.

MCP: https://www.file.rocks/api/mcp
REST: https://www.file.rocks/api/v1

## Start

- [Overview](https://www.file.rocks/docs.md): file.rocks docs for humans and agents
- [Quickstart](https://www.file.rocks/docs/quickstart.md): API key → first list and search in minutes
- [Concepts](https://www.file.rocks/docs/concepts.md): Workspaces, buckets, files, intelligence, MCP

## API

- [API overview](https://www.file.rocks/docs/api.md): REST base URL, auth, and resource map
- [Auth](https://www.file.rocks/docs/api/auth.md): Bearer API keys and scope enforcement
- [Workspaces](https://www.file.rocks/docs/api/workspaces.md): List and inspect workspaces
- [Buckets](https://www.file.rocks/docs/api/buckets.md): List, create, update, and delete buckets
- [Files](https://www.file.rocks/docs/api/files.md): List, search, patch, upload, and download
- [Intelligence](https://www.file.rocks/docs/api/intelligence.md): Config, progress, and backfill
- [Agent](https://www.file.rocks/docs/api/agent.md): Natural-language questions over a bucket
- [Shares & transfers](https://www.file.rocks/docs/api/shares-transfers.md): List shares and transfers
- [Errors & scopes](https://www.file.rocks/docs/api/errors.md): Status codes, errors, and scope matrix

## MCP

- [MCP overview](https://www.file.rocks/docs/mcp.md): One-click storage API for agents
- [Install](https://www.file.rocks/docs/mcp/install.md): Cursor, Claude, and generic HTTP clients
- [Tools reference](https://www.file.rocks/docs/mcp/tools.md): Full tool catalog with args and returns
- [Auth & scopes](https://www.file.rocks/docs/mcp/auth.md): API keys, scopes, and bucket allowlists

## Guides

- [API keys](https://www.file.rocks/docs/api-keys.md): Create, scope, restrict, and revoke keys
- [File intelligence](https://www.file.rocks/docs/intelligence.md): Tags, descriptions, embeddings, backfill
- [Bucket agent](https://www.file.rocks/docs/agent.md): Ask questions about files in a bucket