# SchemaSketch

> SchemaSketch is a free MCP server for databases. MCP server letting AI assistants read, edit and export SchemaSketch DBML database diagrams. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI, Web, macOS, Windows, Linux
- **Website:** https://schemasketch.dev/mcp
- **Repository:** https://github.com/schemasketch-dev/schemasketch-mcp-server
- **MCP Registry name:** dev.schemasketch/mcp-server
- **Categories:** [databases](https://ai-powered.com/categories/databases), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README says the server lets MCP-compatible agents list diagrams, read and write DBML, validate schema changes, and convert between DBML and SQL, Laravel migrations and models, Mermaid and PlantUML. Edits go to the same DBML source the SchemaSketch canvas renders, so a diagram changed by an agent opens in the editor without a format change.

Every save passes the same validator the editor uses. Syntax errors and relationships to missing tables or columns block the save, while warnings such as duplicate names or unrecognized types are returned so the agent can correct them.

Access is controlled by a token generated in the SchemaSketch app. A read-only token hides the tools that modify diagrams, which suits agents that only need to inspect or export schemas. The server is also available as a local npm package for clients that only run stdio servers.

## Features

- **Hosted or local server:** Connect through a remote streamable HTTP endpoint or run the npm package locally over stdio.
- **DBML read and write:** Agents list, fetch, create, update and delete diagrams using DBML source.
- **Validation before saving:** Syntax errors and broken references stop a save, and warnings are returned with the result.
- **Multi-format export:** Export diagrams to SQL for several databases, Laravel migrations and models, Mermaid and PlantUML.
- **Import from SQL and diagrams:** Convert SQL DDL, Mermaid erDiagram and PlantUML entity syntax into DBML.
- **Read-only tokens:** Restrict a token to reading so agents cannot change or delete diagrams.

## Good for

- Asking an AI assistant to add tables or columns to an existing database diagram
- Exporting a diagram to MySQL, PostgreSQL or Laravel migrations from an agent
- Converting an existing SQL schema or Mermaid chart into an editable DBML diagram
- Giving a Zapier workflow read-only access to export diagrams
- Reviewing a schema through an agent without risk of changes

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp-server https://mcp.schemasketch.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.schemasketch.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mcp.schemasketch.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.schemasketch.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "serverUrl": "https://mcp.schemasketch.dev/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://mcp.schemasketch.dev/mcp
```

Enter a Name (for example "SchemaSketch"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin. When we checked, this server asked for a bearer token. Add it under HTTP headers as Authorization: Bearer <your token>.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.schemasketch.dev/mcp"
    }
  }
}
```

## Tools

- `get_dbml_syntax_guide`: Returns the DBML syntax reference.
- `list_diagrams`: Lists saved diagrams.
- `get_diagram`: Fetches one diagram's DBML source and positions.
- `validate_dbml`: Parses DBML and reports errors and warnings without saving.
- `create_diagram`: Creates a diagram.
- `update_diagram`: Replaces a diagram's DBML and/or renames it.
- `delete_diagram`: Permanently deletes a diagram.
- `export_sql`: Exports SQL DDL for PostgreSQL, MySQL, SQL Server or Oracle.
- `export_laravel_migrations`: Exports Laravel migration files.
- `export_laravel_models`: Exports Laravel Eloquent models.
- `export_mermaid`: Exports Mermaid erDiagram syntax.
- `export_plantuml`: Exports PlantUML entity syntax.
- `import_sql`: Converts SQL DDL into DBML.
- `import_mermaid`: Converts Mermaid erDiagram syntax into DBML.
- `import_plantuml`: Converts PlantUML entity syntax into DBML.

## FAQ

### Is the MCP server free?

The site says it is included on every account at no cost, with no separate AI tier.

### Is the server open source?

The README and site state the local server is MIT-licensed and published to npm as schemasketch-mcp-server.

### Can the AI break my diagram?

Saves are checked by the editor's validator. Errors such as a relationship to a missing table stop the save, and warnings are returned with the result.

### Do I need to install anything?

No. The hosted endpoint needs only a URL and a token, though clients that only run local servers can use the npm package.

### Is SchemaSketch free?

Yes. SchemaSketch is free to use.

### How do I add SchemaSketch to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp-server https://mcp.schemasketch.dev/mcp

### What are the best alternatives to SchemaSketch?

The closest alternatives to SchemaSketch are Draughtsman, CloudSketch AI, Network Sketcher (Local MCP), Arkanva and AdoMcp.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Draughtsman](https://ai-powered.com/mcp/draughtsman): Draughtsman is an open-source MCP server for developer tools.
- [CloudSketch AI](https://ai-powered.com/mcp/cloudsketch-ai): CloudSketch AI is a freemium MCP server for developer tools.
- [Network Sketcher (Local MCP)](https://ai-powered.com/mcp/network-sketcher-local-mcp): Network Sketcher (Local MCP) is an open-source MCP server for design and media.
- [Arkanva](https://ai-powered.com/mcp/arkanva): Arkanva is an MCP server for developer tools.
- [AdoMcp](https://ai-powered.com/mcp/adomcp): AdoMcp is an open-source MCP server for databases.
- [Sqemo](https://ai-powered.com/mcp/sqemo): Sqemo is a freemium MCP server for databases.
- [Markasso](https://ai-powered.com/mcp/markasso): Markasso is an open-source MCP server for developer tools.
- [schema-mcp](https://ai-powered.com/mcp/schema-mcp): schema-mcp is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/schemasketch
