Repository avatar
Databases
v1.3.1
active

mcp-server

dev.schemasketch/mcp-server

Design database diagrams in DBML: create, edit, validate, export SQL, Laravel, Mermaid.

Documentation

SchemaSketch MCP server

Latest version Tests Downloads Node MCP License SchemaSketch status

Lets AI agents (Claude, Cursor, Windsurf, Gemini and any other MCP client) read and edit your SchemaSketch database diagrams: list them, read and write DBML, validate it, and convert to and from SQL, Laravel migrations and Eloquent models, Mermaid and PlantUML.

1. Get a token

Sign in at schemasketch.dev/app (free), click Connect AI agent, and generate a token. Choose Read & edit, or Read-only if the agent should only look; read-only tokens hide the tools that change diagrams.

2. Connect your agent

Run it locally (npm)

Needs Node 18 or newer. Add this to your MCP client's config:

{
  "mcpServers": {
    "schemasketch": {
      "command": "npx",
      "args": ["-y", "schemasketch-mcp-server"],
      "env": { "SCHEMASKETCH_TOKEN": "your-token" }
    }
  }
}

Instead of a token you can set SCHEMASKETCH_EMAIL and SCHEMASKETCH_PASSWORD; the server then logs in by itself. A token is safer, since it can be read-only, expires, and can be revoked without changing your password.

Or use the hosted server (no install)

Clients that support remote MCP servers with a custom header can connect directly:

{
  "mcpServers": {
    "schemasketch": {
      "url": "https://mcp.schemasketch.dev/mcp",
      "headers": { "Authorization": "Bearer your-token" }
    }
  }
}

In Claude Code: claude mcp add --transport http schemasketch https://mcp.schemasketch.dev/mcp --header "Authorization: Bearer your-token"

Claude Desktop

Download schemasketch.mcpb and drag it onto Claude Desktop; it asks for your token.

Tools

The same 15 tools in every setup:

ToolDoes
get_dbml_syntax_guideReturns the DBML syntax reference. Call it before writing or editing DBML.
list_diagramsLists your saved diagrams.
get_diagramFetches one diagram's DBML source and positions.
validate_dbmlParses DBML and reports syntax errors and warnings, without saving.
create_diagramCreates a diagram.
update_diagramReplaces a diagram's DBML and/or renames it.
delete_diagramPermanently deletes a diagram.
export_sqlSQL DDL (PostgreSQL, MySQL, SQL Server, Oracle) for a diagram or raw DBML.
export_laravel_migrationsLaravel migration files for a diagram or raw DBML.
export_laravel_modelsLaravel Eloquent models (fillable, casts, relationships) for Laravel 10 or 11+.
export_mermaidMermaid erDiagram syntax.
export_plantumlPlantUML entity syntax.
import_sqlConverts SQL DDL into DBML (save it with create_diagram / update_diagram).
import_mermaidConverts Mermaid erDiagram syntax into DBML.
import_plantumlConverts PlantUML entity syntax into DBML.

Good to know

  • The hosted server allows 60 requests a minute per token. Going over returns 429 with retry_after in seconds.
  • An invalid or expired token returns a message telling you to create a new one.
  • Agents work better with the SchemaSketch skill installed: npx skills add SchemaSketch-dev/schemasketch-skills (more install options).

Full documentation: schemasketch.dev/docs

Source and issues

Source: github.com/SchemaSketch-dev/schemasketch-mcp-server. Report problems in its issues or at hello@schemasketch.dev. Changes are listed in CHANGELOG.md.

License

MIT

NPM
schemasketch-mcp-server
Install Command
npm install schemasketch-mcp-server