Study Design Diagram Studio WebMCP MCP server

Study Design Diagram Studio

A browser workspace by Black Swan Causal Labs for creating, reviewing, and exporting epidemiologic study design diagrams.

Live app: https://sdds.blackswancausallabs.com

Features

• Model washout, inclusion, exclusion, covariate assessment, and follow-up windows relative to an index event.
• Edit window dates by dragging timeline edges or entering values, with keyboard controls and Undo.
• Record study details, assessment rules, source notes, footnotes, and abbreviations.
• Save and import structured JSON; export SVG, PDF, and editable PowerPoint diagrams.
• Review a completeness checklist and work with a compatible browser agent through 10 WebMCP tools.

The workspace is session-only. Use Save JSON to preserve edits before leaving. The preloaded example was transcribed from a reference figure and has not been verified against its manuscript. Completeness checks establish information presence, not methodological validity or source accuracy. The app does not extract information from PDFs.

Connect an AI agent

The app exposes ten predefined tools for reading, editing, validating, and exporting the current study design. Human and agent edits share the same canvas and Undo history. There are two ways to connect:

For a remote MCP client:

1. Open Study Design Diagram Studio, select Connect MCP, then Enable connection.
2. Add https://sdds-webmcp-bridge.jdiazdecaro.workers.dev/mcp to your client. Set its Authorization header to the complete copied value, including Bearer , or use Copy MCP config if the client accepts that format.
3. Keep the tab open. Ask the agent to read the current study specification before editing; mutations require its latest revision.
4. Select Disconnect to revoke access. Closing or reloading the page also ends the session. Keys expire after two hours; reconnect for a new key.

The remote bridge is published in the official MCP Registry as io.github.Black-Swan-Causal-Labs/sdds-webmcp. Its metadata is in server.json; see the bridge README for detailed connection, session, development, and deployment instructions.

A website URL alone does not enable arbitrary agents to use WebMCP. Native access needs browser and agent support; remote access needs pairing and custom-header support. The bridge currently does not implement OAuth discovery.

Pairing is optional and sends study tool arguments and results through the Cloudflare relay to the connected agent provider. Anyone with the temporary key can invoke that canvas's tools while connected. Loading the page does not create a relay session, and native WebMCP works without this relay; the browser agent's own data handling still applies.

Local development

Requires Node.js 22.13 or later and npm. Node.js 24 was used for the initial deployment.

npm ci
npm run dev

Create and preview a production build:

npm run build
npm run preview

The app uses React, TypeScript, Vite, Tailwind CSS, Zod, jsPDF, and PptxGenJS. The studio is a static application. Its optional remote MCP bridge runs separately on Cloudflare Workers and Durable Objects; ordinary manual editing and native WebMCP do not require a paired relay session.

Cloudflare deployment

The existing Cloudflare Pages project is sdds, with production branch main and build output dist.

Shortened. The full README is on GitHub.