ether

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.