add_or_remove_template_or_reference
ChatGPTAttach or detach an EXISTING file as a template (style anchor) or reference (terminology/concept anchor) of a preset. Use this tool when: - the user has an existing workspace they want to promote into a preset (e.g. 'use this file as a template for the System Design preset'), - you need to detach a file from a preset, - or you just created a template via create_template_or_reference WITHOUT a presetId and need to attach it now. To create a NEW template/reference file and attach it in a single call, use create_template_or_reference with presetId set — that avoids leaving a detached file in the team. When removing a file leaves it orphaned from all presets, the file is archived automatically. Templates and references are inherently team-scoped (no private/personal templates exist); the preset choice is the only scoping decision.
create_diagram
ChatGPTPREFERRED for creating a diagram from a natural-language prompt — Eraser's AI picks the diagram type, generates the DSL, and renders it. DO NOT pre-classify the user's request into a diagram type yourself. Pass text only (plus destination params) and LEAVE diagramType UNSET unless the user EXPLICITLY named a type (e.g. 'make this a sequence diagram', 'use a cloud architecture diagram'). Eraser's render service has type-specific heuristics and will pick a better type from the prompt than your guess will, especially on ambiguous asks like 'show how X works' or 'diagram the architecture'. BEFORE calling this tool, if the user has not already specified the destination, ASK them these questions (skip any the user has already answered): 1. 'Should I create a new file for this diagram, or add it to an existing file?' — if existing, ask which fileId (or use one they just referenced). 2. If NEW file: 'Should the file be private (just for you) or shared with your team in a folder?' 3. If shared in a folder: 'Which folder?' (or offer to place it at the team root). Do NOT call list_folders or get_folder to invent a destination yourself — ask the user. Pick destination params based on the answers: - Existing file → pass targetFileId - New private file → omit targetFileId, omit folderId, do NOT set isTeamFile - New shared file at team root → omit targetFileId, omit folderId, set isTeamFile: true - New shared file in a folder → omit targetFileId, pass folderId (this implies shared) Returns the new diagram's id in the diagrams[].id field so a follow-up update_diagram/manually_update_diagram call does NOT need a list_diagrams round-trip. Prefer over manually_create_diagram unless you already have hand-written DSL/JSON.
create_document
ChatGPTPREFERRED for populating a document from a natural-language prompt — Eraser's AI generates the markdown. Only callable on a file with an empty document body; if the file already has content, this returns an error and you should call update_document (for natural-language edits) or manually_update_document (to replace verbatim) instead. Prefer over manually_create_document unless you have pre-written markdown to insert verbatim. Presets and templates: the team default preset applies automatically unless you pass presetId (or null). To use one of the preset's templates, name it in text; Eraser picks it the same way the in-app AI chat does. The response's preset and template fields report what was applied (template.selectedBy is 'auto' or 'explicit').
create_file
ChatGPTCreate an empty file, or duplicate an existing file when sourceFileId is provided. Never populates content from a prompt — use create_document/create_diagram for AI generation. BEFORE calling this tool, if the user has not specified destination, ASK: 1. 'Should the file be private (just for you) or shared with your team in a folder?' 2. If shared in a folder: 'Which folder?' (or offer to place it at the team root). Do NOT call list_folders to invent a destination — ask the user. Pick params: - Private file → omit folderId, do NOT set isTeamFile - Shared at team root → omit folderId, set isTeamFile: true - Shared in a folder → pass folderId (this implies shared)
create_folder
ChatGPTCreate a new folder.
create_preset
ChatGPTCreate a new preset (the team-level container for AI styling: templates, references, and rules). After creating, the typical next steps to make the preset useful are: 1. Add example files as templates/references via add_or_remove_template_or_reference (or create_template_or_reference to spin up a fresh template file from a prompt). Templates anchor the visual style; references anchor terminology and concepts. 2. Set the preset's rules via update_rules (e.g. 'always use dark backgrounds', 'prefer sequence diagrams for auth flows'). 3. Optionally mark the preset as the team default by calling update_preset with isDefault: true. This tool only creates the empty preset shell; an agent that stops here will produce a preset with no styling power. Chain the steps above unless the user explicitly only wanted the shell.
create_template_or_reference
ChatGPTCreate a new template (style anchor) or reference (terminology/concept anchor) file and, when presetId is provided, attach it to that preset in a single call. Auto-publishes the file's first version. Templates and references are ALWAYS team-scoped resources under AI Presets — there is no concept of a private/personal template or reference. DO NOT ask the user 'team template or private template?' — that is not a real choice. The only sharing question is which preset to attach it to. Typical use: - User says 'make this a template under <preset>' → pass presetId so the file is attached immediately. - User says 'make a template from this file' without naming a preset → ASK them which preset before calling (or list_presets to show options). DO NOT silently omit presetId; an unattached template is invisible to AI generation and almost never what the user wanted. - User says 'duplicate this file as a template' → pass sourceFileId (and presetId). When presetId is omitted the response includes a warning that the file is detached; treat that as a signal to follow up with add_or_remove_template_or_reference rather than leaving it dangling.
delete_diagram
ChatGPTDelete a diagram from a file.
delete_document
ChatGPTClear a file's document body to an empty markdown document.
delete_file
ChatGPTArchive a file.
delete_folder
ChatGPTDelete a folder. Rejects when the folder is not empty.
delete_preset
ChatGPTDelete a preset. Rejects when the preset has any rules, templates, or references.
export_diagram
ChatGPTRender a canvas diagram to PNG or JPEG and return a temporary image URL. Tell the user to download it from the returned imageUrl.
export_document
ChatGPTExport a file's markdown document body as a downloadable artifact.
export_file
ChatGPTReturns the Eraser file URL for PDF export. NOTE: programmatic PDF export is not yet available via MCP — this returns a link for the user to export from the Eraser app's export menu, not a downloadable PDF. For a diagram image, use export_diagram; for the document body as markdown, use export_document.
get_diagram
ChatGPTFetch a diagram's metadata and DSL/JSON code. For freeform diagrams, set includeFreeformDefinition: true to get the full scene structure (elements, connections, titles). Need a PNG image of the diagram? Use export_diagram instead.
get_document
ChatGPTFetch the full markdown body of a file's document.
get_file
ChatGPTFetch a file's metadata, document outline (headers), and the list of diagrams in it.
get_folder
ChatGPTFetch a folder by id.
get_me
ChatGPTFetch the current user, active team, and team memberships.
get_preset
ChatGPTFetch a preset including its rules, templates, and references.
get_template_or_reference
ChatGPTFetch a template/reference's metadata, document outline, and diagram list.
list_diagrams
ChatGPTList the diagrams contained in a file.
list_files
ChatGPTList files in the team workspace, optionally scoped to a folder.
list_folders
ChatGPTList folders. Pass parentFolderId to scope to direct children of a folder (or null for top-level only). Pass nameContains to resolve a folder the user names by string (e.g. 'the Engineering folder') without paging through the entire tree. Combining the two narrows further (e.g. top-level folders containing 'eng').
list_presets
ChatGPTList the team's presets. Pass nameContains to resolve a preset the user names by string (e.g. 'the Marketing preset') without scanning the full list — much cheaper in context tokens.
list_teams
ChatGPTList the teams the current user belongs to (OAuth), or the teams an organization API key can act on.
manually_create_diagram
ChatGPTADVANCED — most callers should use create_diagram instead. This tool writes a caller-supplied diagram definition VERBATIM into a new diagram; no AI runs. For DSL diagrams (flowchart-dsl, sequence-dsl, etc.) pass the DSL source as code. For freeform diagrams pass a freeform definition as code — either JSON ({"title"?: string, "elements": [ ... ]}) or the equivalent XML; it is parsed and laid out through the freeform render pass (text measurement, connection routing, etc.). Use ONLY WHEN: the user gave you a literal diagram definition to paste, you are converting from a non-Eraser source (other tool's export, programmatic generation), or you need byte-exact output for a reason the AI path cannot satisfy. For any natural-language description of what the diagram should contain (e.g. 'a sequence diagram showing checkout'), use create_diagram — it picks the diagram type, generates the definition, and renders it for a fraction of the output tokens of composing it yourself.
manually_create_document
ChatGPTADVANCED — most callers should use create_document instead. This tool populates an empty file's document body with caller-supplied markdown VERBATIM; no AI runs and the bytes you pass are exactly what gets stored. Only callable on a file with an empty document body; if the file already has content, call manually_update_document (verbatim overwrite) or update_document (targeted AI edit) instead. USE ONLY WHEN: the user gave you literal markdown to paste, you are converting from another format (HTML, Confluence export, programmatic generation), or you need byte-exact output. For any natural-language description of what the document should say, use create_document.
manually_update_diagram
ChatGPTADVANCED — most callers should use update_diagram instead. This tool writes a diagram's complete DSL/JSON (or freeform edits) VERBATIM; no AI runs and the bytes you pass are exactly what gets stored. USE ONLY WHEN: - the user gave you literal DSL/JSON they want pasted as-is, - you are converting from a non-Eraser source (other tool's export, programmatic generation), - or you need byte-exact output for a reason an AI refinement cannot satisfy. DO NOT use this tool just because the current diagram code happens to be in your context (e.g. you just called create_diagram and want to apply a small refinement). For ANY user request phrased as a natural-language edit ('remove the X group', 'add a step', 'change the color', 'rename Y to Z') — even when you already have the full DSL in front of you — call update_diagram instead. Re-emitting the entire DSL here to apply a conceptual edit costs the user large amounts of output tokens, risks accidental edits to unrelated parts, and gives a worse UX than letting Eraser apply the targeted change.
manually_update_document
ChatGPTADVANCED — most callers should use update_document instead. This tool replaces a file's document body with caller-supplied markdown VERBATIM; no AI runs and the WHOLE body is overwritten (no targeted block edits, no preservation of unrelated sections beyond what you re-emit). USE ONLY WHEN: - the user gave you literal markdown they want pasted as-is, - you are converting from a non-Eraser source (HTML, Confluence export, programmatic generation), - or you need byte-exact output for a reason an AI refinement cannot satisfy. DO NOT use this tool just because the current document markdown happens to be in your context. For ANY user request phrased as a natural-language edit ('add a section', 'fix the wording', 'remove that paragraph') — even when you already have the full body in front of you — call update_document instead. Re-emitting the entire body here to apply a conceptual edit costs the user large amounts of output tokens, risks accidental edits to unrelated sections, and gives a worse UX than letting Eraser apply targeted block edits.
manually_update_file
ChatGPTReplace a file's document markdown and/or diagram code in one call. No AI — caller supplies exact markdown/DSL/JSON.
publish_template_or_reference
ChatGPTPublish a new version of a template/reference file.
search
ChatGPTFull-text and semantic search across files or diagrams. Omit 'kind' for content search (finds matching blocks). Use kind: 'file' only to look up a file by name (no block content returned). Use kind: 'diagram' to search within diagram code/titles.
select_team
ChatGPTSet the active team for the session when the user belongs to multiple teams (OAuth only).
update_diagram
ChatGPTUSE THIS for any user request that describes the change in natural language — verbs like 'add', 'remove', 'change', 'rename', 'recolor', 'make it more X', etc. Eraser's AI applies the change to the existing diagram in place; you only send the short instruction (e.g. text: "remove the External Integrations group"), NOT the full new DSL. IMPORTANT: pick this tool even when the full diagram code is already in your context (e.g. from the previous create_diagram or get_diagram response). Re-emitting the entire DSL via manually_update_diagram to apply a one-line conceptual edit is the WRONG default — it wastes a large number of output tokens, increases the chance of accidental edits/typos, and gives a worse UX than letting Eraser apply a targeted change. Only fall back to manually_update_diagram when the user gave you literal code to paste, you are converting from a non-Eraser format, or you need byte-exact output that the AI rewrite path cannot guarantee.
update_document
ChatGPTUSE THIS for any user request that describes the change in natural language — verbs like 'add a section', 'rewrite the intro', 'fix the typo', 'remove the deprecated paragraph', etc. Eraser's AI applies targeted block-level edits to the existing markdown; you only send the short instruction, NOT the full rewritten document. IMPORTANT: pick this tool even when the full document markdown is already in your context (e.g. from a previous create_document or get_file response). Re-emitting the entire body via manually_update_document to apply a conceptual edit is the WRONG default — it wastes large amounts of output tokens, risks accidental edits/typos in unrelated sections, and gives a worse UX than letting Eraser apply a targeted change. Only fall back to manually_update_document when the user gave you literal markdown to paste, you are converting from another format, or you need byte-exact output the AI rewrite path cannot guarantee. Presets and templates: the team default preset applies automatically unless you pass presetId (or null). To use one of the preset's templates, name it in text; Eraser picks it the same way the in-app AI chat does. The response's preset and template fields report what was applied (template.selectedBy is 'auto' or 'explicit').
update_file
ChatGPTUpdate file metadata (title, folder, sharing). When applyTemplate is provided, AI fills the file's document and diagrams from a preset template.
update_folder
ChatGPTRename or move a folder, or bulk-apply a link-sharing setting to every file inside it (recursively). Note: folders do not store linkAccess themselves — to change sharing you MUST pass both linkAccess and applySharingToDescendantFiles: true together.
update_preset
ChatGPTRename a preset or update its metadata (name, description, isDefault). Does NOT modify rules or templates/references — use update_rules and add_or_remove_template_or_reference for those.
update_rules
ChatGPTAdd, update, or remove rules on a preset in a single batched call. Rules are natural-language instructions the AI will follow when generating diagrams/documents under this preset (e.g. 'use dark theme', 'all auth flows should be sequence diagrams'). Typically called as step 3 of the create-preset chain (after create_preset and add_or_remove_template_or_reference), but can be called any time to tune an existing preset.
update_template_or_reference
ChatGPTRename a template or reference file.
create
Claudedelete
Claudeexport
Claudegenerate
ClaudegenerateEdit
Claudeget
Claudelist
Claudesearch
ClaudeselectTeam
Claudeupdate
Claude
