File operation tools (7)
قراءة 4 دقيقة
Seven file-level tools — the part of MCP that actually edits drafts.
1 · read_file
Read a file.
book_token,path(e.g.Chapters/Chapter 1.md)- Returns content + metadata (type, last edited)
2 · edit_file
Replace part of a file (pattern-based).
path,old_text,new_text- Surgical, doesn't disturb other passages
The most-used tool — how AI does revisions.
3 · write_file
Full overwrite.
path,content- ⚠️ Entire file replaced
- For: full rewrite, initial content for a new file
4 · create_file
Create a new file.
path,content,type(manuscript / reference)- Fails if file exists
5 · delete_file
Delete (into per-book trash, not permanent).
path- Restorable for 30 days — see Manage files and folders
6 · append_to_file
Append content to a file.
path,content- For "continue Chapter 3" workflows
7 · search_content
Full-text search.
book_token,query,scope(chapter / book)- Returns matches with path + passage + line
Permission model
Writing Studio book: all seven tools can write any path.
Script Studio book: structured files are read-only (*.scene / *.character / series.json etc.). Writes only allowed in .script_studio/planning/.
See:
Auto-version
Every write tool (edit_file / write_file / create_file / delete_file / append_to_file) auto-creates a version before changing.
See: Auto-version rules
Related
Was this helpful?