- Category: model context protocol
- Auth: DCR_OAUTH
- Composio-managed OAuth available? No
- Tools: 42
- Triggers: 0
- Slug:
ERASER_MCP - Version: 20261018_00
Tools
Add or remove template or reference
Add or remove template or reference
ERASER_MCP_ADD_OR_REMOVE_TEMPLATE_OR_REFERENCEAttach 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_referenceWITHOUT apresetIdand need to attach it now.
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.Input Parameters
Create diagram
Create diagram
ERASER_MCP_CREATE_DIAGRAMPREFERRED 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):- ‘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).
- If NEW file: ‘Should the file be private (just for you) or shared with your team in a folder?’
- 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)
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.Input Parameters
Create document
Create document
ERASER_MCP_CREATE_DOCUMENTPREFERRED 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.Input Parameters
Create file
Create file
ERASER_MCP_CREATE_FILECreate 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:- ‘Should the file be private (just for you) or shared with your team in a folder?’
- 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)
Input Parameters
Create folder
Create folder
Create preset
Create preset
ERASER_MCP_CREATE_PRESETCreate 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:- Add example files as templates/references via
add_or_remove_template_or_reference(orcreate_template_or_referenceto spin up a fresh template file from a prompt). Templates anchor the visual style; references anchor terminology and concepts. - Set the preset’s rules via
update_rules(e.g. ‘always use dark backgrounds’, ‘prefer sequence diagrams for auth flows’). - Optionally mark the preset as the team default by calling
update_presetwithisDefault: 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.
Input Parameters
Create template or reference
Create template or reference
ERASER_MCP_CREATE_TEMPLATE_OR_REFERENCECreate 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
presetIdso 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(andpresetId).
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.Input Parameters
Delete diagram
Delete diagram
Delete document
Delete document
Delete file
Delete file
Delete folder
Delete folder
Delete preset
Delete preset
ERASER_MCP_DELETE_PRESETDelete a preset. Rejects when the preset has any rules, templates, or references.Input Parameters
Export diagram
Export diagram
ERASER_MCP_EXPORT_DIAGRAMRender a canvas diagram to PNG or JPEG and return a temporary image URL. Tell the user to download it from the returned imageUrl. Set format: “drawio” instead to export an editable draw.io (diagrams.net) document — that returns fileUrl rather than imageUrl; download it and save it with a .drawio extension. draw.io export requires a paid plan; on a free team it returns an upgrade error, so fall back to png/jpeg.Input Parameters
Export document
Export document
Export file
Export file
ERASER_MCP_EXPORT_FILEReturns 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.Input Parameters
Get diagram
Get diagram
ERASER_MCP_GET_DIAGRAMFetch 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.Input Parameters
Get document
Get document
Get file
Get file
Get folder
Get folder
Get me
Get me
ERASER_MCP_GET_MEFetch the current user, active team, and team memberships.Get preset
Get preset
Get template or reference
Get template or reference
List diagrams
List diagrams
List files
List files
List folders
List folders
ERASER_MCP_LIST_FOLDERSList 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’).Input Parameters
List presets
List presets
ERASER_MCP_LIST_PRESETSList 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.Input Parameters
List teams
List teams
ERASER_MCP_LIST_TEAMSList the teams the current user belongs to (OAuth only).Manually create diagram
Manually create diagram
ERASER_MCP_MANUALLY_CREATE_DIAGRAMADVANCED — 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.Input Parameters
Manually create document
Manually create document
ERASER_MCP_MANUALLY_CREATE_DOCUMENTADVANCED — 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.Input Parameters
Manually update diagram
Manually update diagram
ERASER_MCP_MANUALLY_UPDATE_DIAGRAMADVANCED — 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.
Input Parameters
Manually update document
Manually update document
ERASER_MCP_MANUALLY_UPDATE_DOCUMENTADVANCED — 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.
Input Parameters
Manually update file
Manually update file
ERASER_MCP_MANUALLY_UPDATE_FILEReplace a file’s document markdown and/or diagram code in one call. No AI — caller supplies exact markdown/DSL/JSON.Input Parameters
Publish template or reference
Publish template or reference
Search
Search
ERASER_MCP_SEARCHFull-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.Input Parameters
Select team
Select team
Update diagram
Update diagram
ERASER_MCP_UPDATE_DIAGRAMUSE 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.Input Parameters
Update document
Update document
ERASER_MCP_UPDATE_DOCUMENTUSE 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.Input Parameters
Update file
Update file
ERASER_MCP_UPDATE_FILEUpdate file metadata (title, folder, sharing). When applyTemplate is provided, AI fills the file’s document and diagrams from a preset template.Input Parameters
Update folder
Update folder
ERASER_MCP_UPDATE_FOLDERRename 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.Input Parameters
applySharingToDescendantFiles: true; passing linkAccess alone is rejected with an invalid-params error.Update preset
Update preset
ERASER_MCP_UPDATE_PRESETRename 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.Input Parameters
Update rules
Update rules
ERASER_MCP_UPDATE_RULESAdd, 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.