Tools
Ether's MCP server, at https://etherfs.app/mcp, gives the agents you connect these
tools for
working on the files in your workspace. To add it to your agent, follow the
install steps.
A tool's changes are saved as soon as it runs. Tools that only read never change your files; to review the others before they run, turn on your agent's tool approval setting.
The tools
| Tool | What it does | Files |
|---|---|---|
| Explore | ||
read | Read a file, with its lines numbered, or list a folder. Images are shown to the agent. | Reads |
glob | Find files by name with a glob pattern, such as **/*.md. | Reads |
grep | Search the contents of files for text or a regular expression. | Reads |
history | List a file's stored versions from the last 30 days, with when each was saved and which app saved it. Quick successive edits are saved as one. | Reads |
diff | Show what changed in a file between two saved versions, or since one. | Reads |
| Change | ||
edit | Replace exact text in a file. | Changes |
write | Create a file, or overwrite one the agent has read. It's refused if the file has changed since. | Changes |
patch | Add, change, rename and delete several files at once. If any part fails, no file changes. | Changes |
restore | Restore any file to a saved version, even one that was deleted. | Changes |
| Organize | ||
move | Move or rename a file or folder. A file's comments move with it. | Changes |
delete | Delete a file, or a folder and everything in it. A file's comments are deleted with it. | Changes |
| Transfer | ||
upload | Make a single-use link, good for 15 minutes, that copies files from the agent's computer into a folder, without sending them through the chat. | Changes |
download | Make a single-use link, good for 15 minutes, that copies a file or folder to the agent's computer, without sending it through the chat. | Reads |
Paths
Every path is relative to your workspace, so /notes/plan.md and notes/plan.md are
the same file. A tool can't reach outside it.
Your files as resources
In agents that support MCP resources, you can also attach a file from your workspace to a chat yourself, finding it by its path, which they complete as you type.