create_page — MCP tool

added 2026-10-08

Create a page (edit access); without parent it is top level, without after it goes last. Issue keys (SPD-12) in the body link to the issue; `[Title](/p/KEY/pages/N)` links a page. Max 2000 pages, 10 levels.

afterintegeroptional
Sibling to go behind
idempotency_keystringoptional
Optional, 1–128 visible ASCII characters (a UUIDv4 is fine). The same key and arguments within 24 h return the original result and create nothing; the same key with different arguments is rejected. The key is scoped to you and to this tool, and shared with the HTTP Idempotency-Key header.
markdownstringoptional
First body as Markdown; ![title](https://sysdraw.app/s/<token>) = sysdraw view link; a ```mermaid block is drawn as a diagram
parentintegeroptional
Parent page (omit: top level)
projectstringrequired
Project key
titlestringrequired
Page title

Returns

base_revintegerrequired
Next update_page's base_rev
changedbooleanoptional
numberintegerrequired
replayedbooleanoptional
idempotency_key was used before: no page was created
titlestringrequired
urlstringrequired
versionintegerrequired

2026-10-09 — The markdown of a page takes what descriptions take: a sysdraw view link written as an image line, ![title](https://sysdraw.app/s/<22-character token>), and a fenced ```mermaid code block, which the web app draws as a diagram (the source stays in the body and get_page gives it back unchanged). Config directives (%%{init: ...}%%), front matter (a leading --- block) and image shapes are not drawn, and neither is a diagram over about 20 000 characters or 500 lines.