Guides

MCP Server

Introduction

The Eraser MCP server connects AI coding agents to Eraser, letting them generate, create, read, search, and update files, diagrams, folders, and presets in your Eraser workspace — all through the Model Context Protocol.

The remote server is hosted at https://app.eraser.io/api/mcp and uses OAuth for authentication. When you first connect, your MCP client will open a browser window to authorize access to your Eraser account.

Capabilities

  • AI diagram generation — Describe a system, flow, or architecture in natural language and have your agent generate a complete Eraser diagram with full control over styling, color, typeface, and layout direction
  • AI diagram editing — Iteratively edit existing diagrams with natural language instructions
  • Diagram export — Render diagrams to PNG or JPEG with configurable theme, quality, and background
  • File management — Create, list, read, update, search, and archive Eraser files with document and diagram content
  • Diagram management — Create, read, update, and delete individual diagrams within files
  • Folder management — Organize files into folders with full CRUD support
  • Preset management — Create and manage AI presets with custom rules to control diagram generation style and behavior
  • Full-text search — Search across files and diagrams in your workspace

Installation and setup

The remote MCP server URL for all clients is:

https://app.eraser.io/api/mcp

After adding the server, your client will prompt you to authenticate via OAuth in the browser.

Claude Code

claude mcp add --transport http eraser https://app.eraser.io/api/mcp

Claude (claude.ai)

Open the Eraser connector page and click Connect.

Cursor

Add to your Cursor MCP config (.cursor/mcp.json):

{
  "mcpServers": {
    "eraser": {
      "url": "https://app.eraser.io/api/mcp"
    }
  }
}

Codex

Using CLI

codex mcp add eraser --url https://app.eraser.io/api/mcp

Using Desktop App

Open the Codex desktop app and go to Settings > MCP servers > Add server. Choose Streamable HTTP, then enter:

Name: Eraser 
URL: https://app.eraser.io/api/mcp

VS Code

Add to your VS Code MCP config (.vscode/mcp.json):

{
  "inputs": [],
  "servers": {
    "eraser": {
      "url": "https://app.eraser.io/api/mcp",
      "type": "http"
    }
  }
}

GitHub Copilot

Add to your VS Code settings.json:

{
  "mcp": {
    "servers": {
      "eraser": {
        "url": "https://app.eraser.io/api/mcp",
        "type": "http"
      }
    }
  }
}

Kiro

Add to your Kiro MCP config – .kiro/settings/mcp.json for a single workspace, or ~/.kiro/settings/mcp.json to make it available across all workspaces:

{
  "mcpServers": {
    "eraser": {
      "url": "https://app.eraser.io/api/mcp",
      "type": "http"
    }
  }
}

Microsoft Copilot Studio

We recommend API key auth for Copilot Studio.

  1. Create or open an agent.
  2. Go to Tools → Add tool → New tool → Model Context Protocol.
  3. Fill in:
    • Server name: Eraser MCP
    • Server description: Generate, edit, and manage Eraser diagrams and documents
    • Server URL: https://app.eraser.io/api/mcp
    • Authentication: API key, with Type Header and Header name Authorization
  4. Select Create, then open the Connection dropdown and select Create new connection.
  5. In the connection field, paste your key with the Bearer prefix:
   Bearer YOUR_API_KEY
  1. Select Create, then Add and configure. The Eraser tools are now available to your agent.
  2. Test the agent in the test panel to confirm the Eraser tools respond.
  3. Select Publish and confirm.

Make available in Microsoft 365 Copilot

  1. Go to the Channels tab and select Microsoft 365 Copilot and Teams.
  2. Confirm Make agent available in Microsoft 365 Copilot is checked, use Edit details to set the display name, icon, and description, then Save.
  3. Save again to submit for admin review.
  4. Set availability: share directly with yourself or specific people and groups, or have an admin approve it to the org catalog.

The agent then appears in the Microsoft 365 Copilot app and Teams, where you select or @mention it in a chat.

FAQ

Is it free?

Yes. The Eraser MCP server is free to use and subject to the same free tier limits as in-app usage.

What can the Eraser MCP do?

With the Eraser MCP, agents can generate diagrams and documents from natural language, create and manage files in your Eraser workspace, and read or update existing diagrams and documents. See Capabilities above for the full list.

Which server and auth method should I use?

The remote server with OAuth is recommended for most users. It requires no installation and authenticates securely via your Eraser account. API key auth and the local server are better suited for agentic pipelines where users may not have their own Eraser accounts, or for environments that don't support OAuth.

Does it support API key authentication?

Yes. Obtain an API key from your Eraser account settings. Pass it as the ERASER_API_KEY environment variable, or send it on the Authorization header as a bearer token (Bearer YOUR_API_KEY) for clients like Microsoft Copilot Studio. Note that API key auth consumes team-level AI credits and attributes actions to the team rather than an individual user, whereas OAuth consumes the connecting user's AI credits and attributes actions to that user.

Does it support a local MCP server?

Yes. The local server is available as @eraserlabs/eraser-mcp on npm and uses API key authentication. Replace your_api_key with your key from Eraser account settings.

Claude Code:

claude mcp add eraser -- npx -y @eraserlabs/eraser-mcp

Then set ERASER_API_KEY in your environment or Claude Code's MCP env config.

Cursor / VS Code / GitHub Copilot — add to your MCP config:

{
  "mcpServers": {
    "eraser": {
      "command": "npx",
      "args": ["-y", "@eraserlabs/eraser-mcp"],
      "env": {
        "ERASER_API_KEY": "your_api_key"
      }
    }
  }
}

Where are files and diagrams saved?

All files and diagrams are saved to your Eraser account and accessible from the Eraser app.

Who can access files I've generated?

Only you. Files are created under your identity and are private by default. You can change the access level and link sharing settings at any time, either in the Eraser app or via the update tool.

Does it use AI credits?

Yes. Calls that involve AI generation will use AI credits from your Eraser account.

Something missing?

Reach out to the Eraser team at [email protected].