
mcp-server
dev.schemasketch/mcp-server
Design database diagrams in DBML: create, edit, validate, export SQL, Laravel, Mermaid.
Documentation
SchemaSketch MCP server
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:
| Tool | Does |
|---|---|
get_dbml_syntax_guide | Returns the DBML syntax reference. Call it before writing or editing DBML. |
list_diagrams | Lists your saved diagrams. |
get_diagram | Fetches one diagram's DBML source and positions. |
validate_dbml | Parses DBML and reports syntax 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 | SQL DDL (PostgreSQL, MySQL, SQL Server, Oracle) for a diagram or raw DBML. |
export_laravel_migrations | Laravel migration files for a diagram or raw DBML. |
export_laravel_models | Laravel Eloquent models (fillable, casts, relationships) for Laravel 10 or 11+. |
export_mermaid | Mermaid erDiagram syntax. |
export_plantuml | PlantUML entity syntax. |
import_sql | Converts SQL DDL into DBML (save it with create_diagram / update_diagram). |
import_mermaid | Converts Mermaid erDiagram syntax into DBML. |
import_plantuml | Converts PlantUML entity syntax into DBML. |
Good to know
- The hosted server allows 60 requests a minute per token. Going over returns
429withretry_afterin 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
schemasketch-mcp-servernpm install schemasketch-mcp-server