Stable Baseline is a documentation platform with 60+ MCP tools for creating and maintaining structured documents, 40+ diagram types (Mermaid, BPMN, D2, PlantUML, Vega and more), project plans with tasks and phases, and improvement tracking. Connect your AI agent to create, edit, and search documentation, insert interactive diagrams, manage project plans, and track improvements — all through a single MCP server. Documents use the CDMD format with version history, folder organization, and semantic search.
createDocumentCreate a document from CDMD markdown. Call getCdmdLanguageGuide first if unfamiliar with syntax. Do not include DIAGRAM/IMAGE markers — insert them after with dedicated tools.
cdmdstringprojectIdstringchangeSummarystringVersion history summary.
folderIdstringtitlestringcreateFolderCreate a folder in a project. Supports nesting via parentId.
namestringprojectIdstringparentIdstringpositionnumbercreateImageUploadSessionCreate a PUT upload URL for a document image (max 10MB). Use the returned assetUrl with insertImageInDocument.
documentIdstringfileNamestringOriginal filename (e.g. screenshot.png).
mimeTypestringImage MIME type (e.g. image/png).
sha256stringOptional SHA-256 hex digest.
createVegaDataUploadSessionCreate a PUT upload URL for a Vega/Vega-Lite data file. Use returned assetUrl in your Vega spec.
documentIdstringfileNamestringOriginal filename (e.g. sales-data.csv). Extension auto-detects content type.
contentTypestringMIME type override. Auto-detected from extension if omitted.
deleteDiagramInDocumentDelete a diagram from a document.
diagramIdstringDiagram ID from DIAGRAM_OMITTED markers.
deleteDocumentDelete a document.
documentIdstringdeleteFolderDelete a folder recursively, including all nested folders and documents.
folderIdstringdeleteImageInDocumentDelete an image from a document and storage.
imageIdstringImage ID from IMAGE_OMITTED markers.
deleteVegaDataFileDelete a data file attachment from a document.
attachmentIdstringAttachment ID to delete.
documentIdstringeditDocumentEdit a document with line-based patches. Call getDocument first for line numbers and versionTimestamp. Call getCdmdLanguageGuide if unfamiliar with CDMD syntax. Do not edit DIAGRAM/IMAGE markers manually — use dedicated diagram/image tools.
documentIdstringversionTimestampnumberVersion timestamp from getDocument() for optimistic locking.
changeSummarystringVersion history summary.
folderIdstringMove to this folder.
patchesarrayLine-based patches. Can be empty if only updating title or folderId.
titlestringNew title.
findAndReplaceTextInDocumentFind and replace text in a document. Searches for all occurrences and replaces them. Case-sensitive by default. Diagrams/images are automatically protected — only document text is affected.
documentIdstringfindstringText to search for.
replacestringReplacement text. Empty string to delete occurrences.
caseSensitivebooleanCase-sensitive matching. Default: true.
changeSummarystringVersion history summary.
getCdmdLanguageGuideGet the CDMD markdown language specification. Call before createDocument if unfamiliar with syntax.
getDiagramInDocumentGet a diagram's full details including raw DSL source code. Use diagramId from DIAGRAM_OMITTED markers in getDocument output. Returns diagramCode, type, name, nlDescription, and versionTimestamp.
diagramIdstringDiagram ID from DIAGRAM_OMITTED markers.
fieldsarrayField projection. Valid fields: diagramId, documentId, type, name, diagramCode, nlDescription, colorPlan, renderStatus, renderError, createdAt, updatedAt, versionTimestamp.
getDiagramTypeGuideGet DSL writing instructions for a diagram type. Call before writing diagramCode.
typestringfieldsarrayField projection. Valid fields: type, label, description, whenToUse, dslLanguage, dslInstructions, exampleDsl, enabled, sortOrder, updatedAt.
getDocumentRead a document's content with line numbers. Returns numbered lines for use with editDocument. Diagrams/images appear as OMITTED markers with metadata (type, diagramId, nlDescription) — use getDiagramInDocument(diagramId) for full DSL code, or dedicated diagram/image tools to manage them.
documentIdstringThe document ID to read.
contentFieldsarrayContent field projection. Valid fields: offset, limit, totalLines, nextOffset, metadata, text.
fieldsarrayField projection. Valid fields: id, title, friendlyId, friendlyIdNumber, projectId, folderId, createdAt, updatedAt, versionTimestamp.
limitnumberMax lines to return. Default: 200.
offsetnumberLines to skip from start. Default: 0.
getFolderHierarchyGet the folder and document tree starting from a specific folder. Alias for getProjectHierarchy with folderId.
folderIdstringThe folder ID to start from.
dateFieldstringDate field to filter. Default: updated_at.
fromDatestringISO 8601 date filter (from).
includeDocumentsbooleanInclude documents. Default: true.
maxDepthnumberMax nesting depth. Default: 10, max: 20.
querystringFilter by name/title (case-insensitive).
toDatestringISO 8601 date filter (to).
getImageInDocumentGet image details including a fresh signed URL (expires after 1 hour). Use storagePath from IMAGE_OMITTED markers in getDocument output.
documentIdstringstoragePathstringStorage path from IMAGE_OMITTED marker.
getProjectHierarchyGet the complete folder and document tree for a project in one call. Recommended first call for navigation.
dateFieldstringDate field to filter. Default: updated_at.
folderIdstringStart from this folder instead of project root.
fromDatestringISO 8601 date filter (from).
includeDocumentsbooleanInclude documents. Default: true.
maxDepthnumberMax nesting depth. Default: 10, max: 20.
projectIdstringProject ID. Required if folderId not provided.
querystringFilter by name/title (case-insensitive).
toDatestringISO 8601 date filter (to).
insertDiagramInDocumentInsert a new diagram into a document. Call listDiagramTypes to find your type, then getDiagramTypeGuide for DSL syntax before writing diagramCode.
afterLinenumberInsert after this line number (1-based).
alignstringAlignment.
leftcenterrightcaptionstringCaption below the diagram.
diagramCodestringDiagram DSL code. Call getDiagramTypeGuide for syntax.
documentIdstringdocumentVersionTimestampnumberVersion timestamp from getDocument() for optimistic locking.
nlDescriptionstringExtended description of the diagram (2-4 sentences).
promptstringShort description of what the diagram shows (1-2 sentences).
typestringDiagram type (e.g. mermaid, plantuml, bpmn, d2). Call listDiagramTypes for all types.
colorPlanobjectBPMN only. Color plan: { byElementId: { ElementId: SwatchName } }.
insertImageInDocumentInsert an image into a document (max 10MB). Provide imageBase64, imageBinary, or imageUrl. For large files, call createImageUploadSession first then use the returned assetUrl.
captionstringCaption below the image.
documentIdstringdocumentVersionTimestampnumberVersion timestamp from getDocument() for optimistic locking.
nlDescriptionstringDescription of image content for semantic search.
afterLinenumberInsert after this line (0 = beginning, omit = end).
alignstringAlignment. Default: center.
leftcenterrightaltstringAlt text. Defaults to caption.
fileNamestringOriginal filename.
heightnumberHeight in pixels.
imageBase64stringBase64-encoded image data. Mutually exclusive with imageBinary/imageUrl.
imageBinaryarrayRaw binary as byte array. Mutually exclusive with imageBase64/imageUrl.
imageUrlstringURL to fetch image from, or assetUrl from createImageUploadSession.
widthnumberWidth in pixels.
listArchitectureIconsList icons for systemsarchitecture diagrams. Use returned iconPath as-is in D2 code (e.g. icon: dev/docker.svg).
categorystringFilter by category (e.g. AWS, Azure, GCP, dev, essentials).
fieldsarrayField projection. Valid fields: id, iconPath, iconName, category, subcategory, vendor, description, searchTerms, tags, useCases, aliases, isFeatured, displayOrder.
limitnumberoffsetnumberquerystringSearch by name, category, vendor, or description.
listDiagramTypesList supported diagram types. Use the returned type field when calling insertDiagramInDocument.
enabledOnlybooleanfieldsarrayField projection. Valid fields: type, label, description, whenToUse, dslLanguage, dslInstructions, exampleDsl, enabled, availableOnFree, sortOrder, updatedAt.
limitnumberoffsetnumberquerystringlistDocumentsList documents in a project, workspace, or folder. Supports query search and date filtering.
dateFieldstringDate field to filter. Default: updated_at.
fieldsarrayField projection. Valid fields: id, title, friendlyId, friendlyIdNumber, projectId, folderId, createdAt, updatedAt, href.
folderIdstringfromDatestringISO 8601 date filter (from).
limitnumberoffsetnumberprojectIdstringquerystringtoDatestringISO 8601 date filter (to).
workspaceIdstringlistDocumentVersionsList version history for a document. Returns timestamps, creator, change summary, and content.
documentIdstringfieldsarrayField projection. Valid fields: id, documentId, versionNumber, title, contentMarkdown, changeSummary, createdBy, createdAt.
fromDatestringISO 8601 date filter (from).
limitnumberMax versions. Default: 50, max: 200.
offsetnumberPagination offset.
sortAscendingbooleanSort oldest first. Default: false.
toDatestringISO 8601 date filter (to).
versionNumbernumberFilter to a specific version.
listFoldersList folders in a project. Use parentId for nested folders. For full tree, use getProjectHierarchy instead.
projectIdstringdateFieldstringDate field to filter. Default: updated_at.
fieldsarrayField projection. Valid fields: id, projectId, parentId, name, position, createdAt, updatedAt.
fromDatestringISO 8601 date filter (from).
limitnumberoffsetnumberparentIdstringquerystringtoDatestringISO 8601 date filter (to).
listImprovementsList improvements in a project. Supports filtering by status, type, priority, and query.
projectIdstringagentReadybooleanFilter by agent readiness.
categoryIdstringFilter by category ID.
complianceOnlybooleanOnly compliance-linked improvements.
frameworkKeystringFilter by framework (e.g. soc2, iso27001).
prioritystringFilter: low, medium, high, critical.
querystringSearch title, friendly_id, problem_statement.
scanRunIdstringFilter by compliance scan run.
sortAscendingbooleanSort ascending. Default: true.
sortFieldstringSort field. Default: position.
sourcestringFilter: agent_review, human_manual, doc_comment, feedback, incident, etc.
statusstringFilter: captured, triaging, shaped, approved, ready_for_agent, in_progress, blocked, done, rejected, deferred.
typestringFilter: feature, bug, tech_debt, architecture_gap, documentation_gap, risk, enhancement.
listOrganisationsList organisations you have access to. Supports query filtering by name/slug.
fieldsarrayField projection. Valid fields: id, name, slug, subscription_tier, created_at.
limitnumberoffsetnumberquerystringlistProjectsList projects in a workspace. Supports query filtering by project name.
workspaceIdstringdateFieldstringDate field to filter. Default: updated_at.
fieldsarrayField projection. Valid fields: id, name, description, workspace_id, created_at, updated_at.
fromDatestringISO 8601 date filter (from).
limitnumberoffsetnumberquerystringtoDatestringISO 8601 date filter (to).
listWorkspacesList workspaces you have access to. Supports query filtering by name/slug.
dateFieldstringDate field to filter. Default: updated_at.
fieldsarrayField projection. Valid fields: id, name, slug, organization_id, created_at, updated_at.
fromDatestringISO 8601 date filter (from).
limitnumberoffsetnumberquerystringtoDatestringISO 8601 date filter (to).
searchToolsSearch available tools by keyword or category. Returns matching tool names and descriptions.
categorystringCategory filter.
navigationfoldersdocumentsdiagramsimagesdataimprovementsplansquerystringNatural language description of what you want to do.
updateDiagramInDocumentUpdate a diagram's code, description, or properties. Call getDiagramTypeGuide for DSL syntax. Requires documentVersionTimestamp from getDocument. IMPORTANT: To change what the diagram visually shows, you MUST provide diagramCode with the full updated DSL source. The prompt and nlDescription fields are metadata only and do NOT change the rendered diagram.
diagramIdstringDiagram ID from DIAGRAM_OMITTED markers.
documentVersionTimestampnumberVersion timestamp from getDocument() for optimistic locking.
alignstringAlignment.
leftcenterrightcaptionstringNew caption.
colorPlanobjectBPMN only. Updated color plan. Set to null to remove.
diagramCodestringNew diagram DSL source code. REQUIRED to change what the diagram visually renders. Call getDiagramTypeGuide for syntax. Must provide the COMPLETE updated DSL, not just the changed parts.
nlDescriptionstringNew extended description (metadata only — does NOT change the rendered diagram).
promptstringNew short description (metadata only — does NOT change the rendered diagram).
updateFolderUpdate a folder (rename/move/reorder). Supports nesting changes via parentId.
folderIdstringnamestringparentIdstringpositionnumberupdateImageInDocumentUpdate image metadata (alt, caption, dimensions, alignment). Requires documentVersionTimestamp from getDocument for optimistic locking.
documentVersionTimestampnumberVersion timestamp from getDocument() for optimistic locking.
imageIdstringImage ID from IMAGE_OMITTED markers.
alignstringAlignment.
leftcenterrightaltstringNew alt text.
captionstringNew caption.
heightnumberHeight in pixels.
nlDescriptionstringNew image description.
widthnumberWidth in pixels.