Datadef
OnlineGenerate, edit, and export data-architecture diagrams from your AI. Column lineage, PNG in chat.
What it can do: 39 tools
get_design_guideread-onlyWhen: read once before your first canvas_* call, to build or to edit. Datadef's standard for a readable diagram (size, edge discipline, nested zones, notes) and the tool workflow: which canvas_* tool to use when, batchincanvas_describe_canvasread-onlyWhen: Use when you want a flat list of every node, edge and zone. canvas_view shows the same ids as a zone tree with positions and defects, and is usually the better first read. Get an overview of the current canvas: zocanvas_inspect_nodesread-onlyWhen: Use before changing a node's fields or columns, to see everything it carries: columns, metadata, owners, neighbours. Get full detail for specific nodes: all columns with types and keys, metadata, schedule, formulacanvas_search_iconsread-onlyWhen: Use before adding nodes that should show a vendor logo (Snowflake, Kafka, Power BI) and you are unsure of the icon id. Find icon ids in Datadef's library (2000+ cloud and data-tool logos) by product name, e.g. "Amcanvas_measure_canvasread-onlyWhen: Use only for a precise manual placement the user asked for: exact x/y/width/height per node. To check a layout, canvas_view is faster and already reports overlaps. Get exact geometry: every node's position and sizcanvas_add_nodesWhen: Use to add components (tables, pipelines, sources, consumers, service icons), each placed in its zone with `group`. Add one or more nodes to the canvas. Batch every node you want in a single call. Positions are ascanvas_add_standalone_nodeWhen: Use only when the user wants a node at a specific position, outside the automatic layout. Otherwise use canvas_add_nodes. Add a single data node at an exact position, without connecting it to anything. Use when thcanvas_update_nodesWhen: Use for any in-place change: rename a node or zone (it keeps its size and contents), edit a note's text, recolour (`color: "green"`, `fill`, `family`), change a zone's style, swap an icon, or change a data node's tcanvas_replace_nodeWhen: Use when one component changes identity or type (Redshift becomes Snowflake, a card becomes a service icon). The node keeps its id, connections, lineage, zone, position and fields. Turn a node into a different comcanvas_remove_nodesWhen: Use to delete nodes and their edges. Removing a zone keeps its contents (they move up to the parent, same place on screen): that is how to ungroup. Pass keepChildren:false only to delete the zone with everything incanvas_connect_nodesWhen: Use to draw the flows that genuinely move data between two nodes. Never connect a zone: connect a node inside it. Draw edges (arrows) between nodes to show how data flows. Label an edge only when the reader couldcanvas_update_edgesWhen: Use to relabel, retype, restyle (dashed, colour), reverse, put arrowheads on both ends, or re-point an existing edge, instead of disconnecting and reconnecting it. Change existing connections in place: relabel, recanvas_disconnect_nodesWhen: Use to delete specific edges between two nodes. Remove edges, given as source and target, or as an edge id / "Source -> Target" string in `edge`. Batch: `edges` takes a list; put every item in one call rather thacanvas_set_columnsWhen: Use `mode: "merge"` to add or update (renameTo) a few columns, `mode: "remove"` to drop some, or the default replace for the full list. Columns that stay keep their ids and lineage. Change a table's columns. modecanvas_group_nodesWhen: Use to create a zone (a layer, domain, stage or boundary), nested with `parentGroup`, optionally moving existing nodes into it: the zone is drawn around them where they are, inside the zone they already share. Crecanvas_move_to_groupWhen: Use to move existing nodes or zones into another zone (they are placed inside it and the zone grows to fit), or out of every zone with group null. A zone cannot move into its own sub-zone. Move existing nodes or zcanvas_add_lineageWhen: Use to record which source columns produce which target columns. No line is drawn. Record column-level lineage: which source column produces which target column, and how. This is what makes the diagram queryable fcanvas_remove_lineageWhen: Use to delete lineage rows between two nodes (one column pair, or all rows between them). Lineage pointing at deleted nodes or columns is cleaned automatically. Delete lineage rows between two nodes: one column pacanvas_add_textWhen: Use for a note that tells the diagram's reader a decision, constraint or gotcha. Pass `anchor` (the node or zone it explains) and it is placed beside it, no coordinates needed. To edit a note's text use canvas_updacanvas_add_shapeWhen: Use rarely: a pointer or highlight the user asked for. Never as a backdrop; zones are the containers. Place a rectangle, circle, arrow, or line as a visual annotation — a divider, a highlight. Shapes are drawings:canvas_add_flow_arrowWhen: Use after the final layout, where one arrow should stand for a bundle of identical flows (zone to zone). Draw one large labelled arrow SHAPE between two areas of the diagram — "ingest", "serve", "publish". It is acanvas_add_regionWhen: Use after the final layout to mark nodes that belong together without moving them into a zone. Regions do not move with layout. Draw a labelled translucent area behind existing nodes to show they belong together,canvas_suggest_simplificationsread-onlyWhen: Use when the diagram feels dense or the user asks to simplify. It changes nothing; it reports what could collapse. Report where this canvas could be collapsed — groups of similar nodes that could become one summarcanvas_collapse_nodesWhen: Use to merge several similar nodes into one while keeping their connections, usually after canvas_suggest_simplifications. Merge several nodes into one summary node, keeping every connection. Use when a set of neacanvas_move_nodesWhen: Use only when the user asked for a specific placement. Moving a zone moves its children; never move the children as well. Set node positions precisely. Use absolute x/y to place something exactly, or dx/dy to nudgcanvas_resize_nodesWhen: Use only when the user asked for a specific size. Set the width and height of nodes. Mostly for shapes, text boxes, and group zones — data nodes size themselves from their content, and resizing one can clip what icanvas_align_nodesWhen: Use only when the user asked for alignment that layout does not give. Align nodes to a shared edge or centre line, or space them evenly. Cleaner and far more reliable than computing coordinates by hand. Batch: `ncanvas_layout_canvasWhen: Use once, after the structure (zones, nodes, edges) is complete, not after each change. With no arguments it only places what was added or changed; nothing else moves. Set mode "full", direction (LR/TB/RL), spacingcanvas_validate_canvasread-onlyWhen: Use before you finish: broken references and icons, nodes outside their zone, overlapping zones or nodes. Loops are reported as information only. Check your work: broken references, broken icons, nodes sticking oucanvas_viewread-onlyWhen: use to see a diagram before you edit it and after each round of changes; this is how you check your work. It answers in milliseconds from the saved diagram, where export_diagram starts a browser for 6-10 s. Returncanvas_batchWhen: use whenever you would otherwise make several canvas_* write calls in a row, above all with tools that take one item per call: create every zone (group_nodes), convert many nodes (replace_node), set several tables'create_diagramWhen: use when Datadef's own model should design a whole new diagram from a description or a pasted schema. To build it yourself step by step, use create_blank_diagram; to change an existing diagram, canvas_view and thecreate_blank_diagramWhen: use when you will build the diagram yourself with the canvas_* tools, because you want control over the result or already know the architecture from the conversation. Use create_diagram instead when Datadef's modellist_diagramsread-onlyWhen: use to find the id of an existing diagram before viewing, editing or exporting it. Lists the diagrams in the user's Datadef account, most recently updated first. Next: canvas_view with the diagram_id to see it.get_diagramread-onlyWhen: use to show the user a diagram (it attaches a rendered PNG and a markdown image line, 6-10 s), or to poll a diagram that create_diagram or edit_diagram is still working on. To check your own edits, canvas_view is fedit_diagramWhen: use for a large change you can describe in words better than you can make it tool by tool: "reorganise this into bronze, silver and gold", "rebuild the consumption side from this spec", "add owners and schedules evexport_diagramread-onlyWhen: use to give the user an image of a diagram, or a link to download, attach or embed one. Not to check your own edits: a render starts a browser (6-10 s), while canvas_view answers in milliseconds and reports overlaprepo_statusread-onlyFor a diagram that was created from a connected git repository: which repo and branch or tag it tracks, when it last synced, the commit it reflects, and whether daily sync is on. Use repo_refresh to sync it now. Only therepo_refreshRe-sync a repo-linked diagram from the current state of its repository. If the tracked branch or tag has not moved since the last sync, nothing changes. If it has, the diagram is REGENERATED from the repository, which re
Connect it
claude mcp add --transport http datadef https://datadef.io/mcpSettings → Connectors → Add custom connector
URL: https://datadef.io/mcp{
"mcpServers": {
"datadef": {
"url": "https://datadef.io/mcp"
}
}
}{
"servers": {
"datadef": {
"type": "http",
"url": "https://datadef.io/mcp"
}
}
}Questions
What does Datadef do?
Generate, edit, and export data-architecture diagrams from your AI. Column lineage, PNG in chat. It exposes 39 tools to AI assistants.
What tools does Datadef provide?
39 tools, including get_design_guide, canvas_describe_canvas, canvas_inspect_nodes, canvas_search_icons, canvas_measure_canvas, canvas_add_nodes, canvas_add_standalone_node, canvas_update_nodes, canvas_replace_node, canvas_remove_nodes, canvas_connect_nodes, canvas_update_edges….
How do I connect Datadef to Claude, ChatGPT or Cursor?
Add the remote MCP endpoint https://datadef.io/mcp as a custom connector or MCP server. Copy-paste setup is on this page.
Does Datadef require an account or API key?
No sign-in was needed to list its tools. Individual tools may still need an account or API key.
Is Datadef online?
As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.
Who publishes Datadef?
datadef.io. The official MCP Registry verified that the publisher controls this domain before accepting the listing.
Similar in Communication
-
BasecampOnline · sign-in requiredOfficialPopularNew
Basecamp's official server: projects, to-dos, cards, messages, docs, schedules, and Campfire.
-
Clutch.coOnlineOfficialPopular
Trusted B2B service providers with verified client reviews
-
Elfsight AI ChatbotOnline · sign-in requiredPopular
Read conversations, leads, knowledge base and analytics of your Elfsight AI Chatbot widgets.
-
HyperFrames by HeyGenOnline · sign-in requiredOfficialNew
Official HyperFrames by HeyGen: the best AI video editor in chat. Captions, motion graphics, MP4.
-
SendPulseOnline · sign-in requiredOfficial
Empower AI agents with SendPulse email, CRM, chatbot, SMTP, and course automation
-
RocketReachOnline · sign-in requiredOfficial
Verified work emails and phones from 700M+ contacts