INDIVIDUAL MCP TOOL

create_blank_diagram

Create an empty diagram and return its diagram_id, so you can build it yourself with the canvas_* tools.

datadef.ionone authenticationAvailability not checked

LIVE ENDPOINT

https://datadef.io/mcp

No auth detected

Connect to this endpoint to inspect the live schema for create_blank_diagram and invoke it with your own arguments.

{}

Potential side effects detected · medium confidence · heuristic, not a guarantee.

CONNECT WITH APPROVAL

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.datadef]
url = "https://datadef.io/mcp"
enabled = true

Claude Code

.mcp.json

{
  "mcpServers": {
    "datadef": {
      "type": "http",
      "url": "https://datadef.io/mcp"
    }
  }
}

Claude Desktop

Settings → Connectors → Add custom connector

Name: datadef
Remote MCP URL: https://datadef.io/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "datadef": {
      "url": "https://datadef.io/mcp"
    }
  }
}

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

{
  "servers": {
    "datadef": {
      "type": "http",
      "url": "https://datadef.io/mcp"
    }
  }
}

Generic MCP

Client-specific MCP configuration

{
  "name": "datadef",
  "transport": "streamable-http",
  "url": "https://datadef.io/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

get_design_guide — Datadef's standard for what makes a diagram readable, size, edge discipline, nested zones, annotations, and the tool order for building or editing.
canvas_describe_canvas — Get an overview of the current canvas: every node with its id, type, label and group, plus all connections and groups.
canvas_inspect_nodes — Get full detail for specific nodes: all columns with types and keys, metadata, schedule, formula, owners.
canvas_measure_canvas — Get exact geometry: every node's position and size in canvas units, the overall canvas bounds, and any nodes that overlap each other.
canvas_suggest_simplifications — Report where this canvas could be collapsed — groups of similar nodes that could become one summary node — without changing anything.
canvas_search_icons — Search Datadef's icon library (2000+ cloud and data-tool logos) for a valid icon id.
canvas_add_nodes — Add one or more nodes to the canvas.
canvas_add_standalone_node — Add a single data node at an exact position, without connecting it to anything.