tldraw

Internal: the view gets a socket address for a live tldraw.com board.

_dotcom_sync_url

Internal: the view syncs the file list and workspaces with tldraw.com.

_dotcom_zero

Create a new, empty tldraw.com board and return its boardId and url. The board goes in your personal workspace unless you name another workspace you belong to and can add boards to — the workspaceName search_boards reports, or a workspace id. If the workspace you name is not one of those, the error lists the ones you can use. The new board is shared by link for editing, the same as a board created on tldraw.com.

create_board

Run JavaScript against an open board, named by its boardId from open_board, list_open_boards or the model context. The code receives the full editor API, helpers (createShapeId, toRichText, createArrowBetweenShapes, createMermaidDiagram, getComments, addComment), and signal. Use search to discover APIs. Return small JSON. Document edits commit atomically as one undo step; addComment posts as the signed-in user, outside that undo step; always await asynchronous work and do not retain editor references or perform external side effects. Returns the actual result, not an acknowledgement. Does not open another app view; if the view is still loading after open_board, this waits for it. On an unknown outcome, inspect the board before retrying.

exec

The tldraw.com account this session is signed in as: a stable id, and the name and email when known. Takes no arguments.

get_profile

Explicitly request a PNG of an open board, named by its boardId. Does not open another view; exec never takes screenshots automatically.

screenshot

List the boards the user has open in tldraw views, in any of their chats or the sidebar: IDs and editability. Only open boards can be edited. An empty list can mean the side panel is still loading.

list_open_boards

List tldraw.com boards this account can reach: the boards in its own workspace, the boards owned by the workspaces it belongs to, and the boards shared with it by link that it has opened. Searching by name is not available on this deployment, so this tool takes no query and lists boards in order instead. Results are ordered by addedAt — when a board joined this account's boards, which is when it was created for its own boards and when the share link was first opened for shared ones — so a board shared this morning leads the list however old it is. createdAt is when the board itself was made, and updatedAt when it last changed, by anyone. Each board's source says how you reach it: owned for your own, workspace for one owned by a workspace you belong to, and shared for one somebody sent you a link to. Returns up to 20 boards, each with a boardId that get_board_info and the other tools take. If the result carries a nextCursor there are more boards: call again with that cursor to get the next page. An empty result is a normal result, not an error.

search_boards

List the tldraw.com workspaces this account belongs to, including its personal workspace. Each workspace comes with its id, name, whether it is the personal one, and this account’s role in it. create_board accepts any of them as workspace.

list_workspaces

Internal: the view lists the signed-in user's tldraw.com boards, one page at a time.

_dotcom_boards