Menu
file.rocks docs for humans and agents·View as Markdown
file.rocks docs
The storage API agents can install in one click — and humans can read without squinting.
file.rocks exposes a scoped REST API and a production MCP server over the same workspaces, buckets, and intelligence features you use in the product.
Prefer MCP in agents
If you're wiring Cursor, Claude, or another MCP client, start here:
- Create an API key with the scopes you need
- Install the MCP server
- Call tools like
list_buckets,search_files, andask_agent
Use REST when you need raw HTTP, scripts, or non-MCP runtimes.
Start here
| Path | For |
|---|---|
| Quickstart | Key → first list/search |
| Concepts | Workspaces, buckets, files, intelligence |
| API overview | Full REST map |
| MCP overview | Tools, auth, install |
Agent discovery
Every page has a markdown twin: append .md (for example /docs/api.md).
- Site map: /llms.txt · /docs/llms.txt
- CORS on markdown:
Access-Control-Allow-Origin: *
Dogfood note
API keys, intelligence, and MCP are gated to the intelligence dogfood allowlist (@terrible.app and explicit allowlists). The product UI for keys only appears when your account qualifies.