Eraser MCP

Attach 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,…

Untrusted display-only summary

PREFERRED 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…

Untrusted display-only summary

PREFERRED 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 v…

Untrusted display-only summary

Create 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 te…

Untrusted display-only summary

Create a new folder.

Untrusted display-only summary

Create 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 fi…

Untrusted display-only summary

Create 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/persona…

Untrusted display-only summary

Delete a diagram from a file.

Untrusted display-only summary

Clear a file's document body to an empty markdown document.

Untrusted display-only summary

Archive a file.

Untrusted display-only summary

Delete a folder. Rejects when the folder is not empty.

Untrusted display-only summary

Delete a preset. Rejects when the preset has any rules, templates, or references.

Untrusted display-only summary

Render 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 exp…

Untrusted display-only summary

Export a file's markdown document body as a downloadable artifact.

Untrusted display-only summary

Returns 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.

Untrusted display-only summary

Fetch 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.

Untrusted display-only summary

Fetch the full markdown body of a file's document.

Untrusted display-only summary

Fetch a file's metadata, document outline (headers), and the list of diagrams in it.

Untrusted display-only summary

Fetch a folder by id.

Untrusted display-only summary

Fetch the current user, active team, and team memberships.

Untrusted display-only summary

Fetch a preset including its rules, templates, and references.

Untrusted display-only summary

Fetch a template/reference's metadata, document outline, and diagram list.

Untrusted display-only summary

List the diagrams contained in a file.

Untrusted display-only summary

List files in the team workspace, optionally scoped to a folder.

Untrusted display-only summary

List 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'…

Untrusted display-only summary

List 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.

Untrusted display-only summary

List the teams the current user belongs to (OAuth only).

Untrusted display-only summary

ADVANCED — 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…

Untrusted display-only summary

ADVANCED — 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_updat…

Untrusted display-only summary

ADVANCED — 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 sour…

Untrusted display-only summary