Study Design Diagram Studio WebMCP

io.github.Black-Swan-Causal-LabsPublished by GitHub account Black-Swan-Causal-Labsv1.0.0Updated Oct 24, 2026

Read and edit a live study design canvas through its predefined WebMCP tools.

The publisher's own server: Diagram

VerifiedStreamable HTTPWeb executableProductivity & WorkflowData & Analytics

Overview

AI-generated overview

Lets an assistant read, edit, validate and export the live epidemiologic study design diagram open in the Study Design Diagram Studio browser app.

What you can do
  • Read the current study specification and its revision number
  • Add, update, remove and reorder timeline windows and design elements
  • Update study-level metadata, import a full specification, or clear the canvas
  • Run completeness checks and review items, and export the schematic as SVG without downloading
When to use it
Useful when you are building or reviewing an epidemiologic study design diagram in the studio and want an assistant to make structured edits, check completeness, or pull the schematic out, while you keep working on the same canvas.
Requirements
A remote Streamable HTTP MCP client that supports custom authorization headers. Open the studio, enable a temporary connection, and set the Authorization header to the copied value. The studio tab must stay open; keys expire after two hours. No OAuth discovery is implemented.
Before you install
The temporary key grants anyone holding it the ability to invoke that canvas's tools while connected, so treat it as a secret and disconnect when done. Pairing sends study tool arguments and results through a Cloudflare relay to the connected agent provider. Edits change the shared canvas and Undo history, and the workspace is session-only, so save JSON before leaving. Completeness checks do not establish methodological validity.

Installation

In SourceWeft

  1. Open Study Design Diagram Studio WebMCP in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Black-Swan-Causal-Labs%2Fsdds-webmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "study-design-diagram-studio-webmcp": {
      "type": "http",
      "url": "https://sdds-webmcp-bridge.jdiazdecaro.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

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:

ConnectionRequirementsSetup
Native WebMCPA WebMCP-capable browser and agentOpen the studio and let the agent discover the page's tools
Remote MCP bridgeA Streamable HTTP MCP client that supports custom authorization headersEnable a temporary connection in the studio and configure the client with its URL and key

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.

sh
npm cinpm run dev

Create and preview a production build:

sh
npm run buildnpm 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.

SettingValue
Custom domainsdds.blackswancausallabs.com
Pages hostnamesdds-1wj.pages.dev
Wrangler configurationwrangler.json
DNS recordCNAME sdds → sdds-1wj.pages.dev

From a checkout with access to the Cloudflare account:

sh
npm cinpx wrangler loginnpm run buildnpx wrangler pages deploy dist --project-name sdds --branch main

Wrangler opens authentication in your default browser. The Pages project and custom domain are already configured; normal redeployments do not require recreating them. For a new environment, create a separate Pages project and add its custom domain through Cloudflare's Pages dashboard.

Deployment is currently manual through Wrangler. Pushing to this GitHub repository does not automatically deploy to Cloudflare. Never commit Cloudflare tokens, .env files, .dev.vars files, or local Wrangler state.

WebMCP tool reference

The app detects document.modelContext, with a fallback to navigator.modelContext. Manual editing remains available in browsers without WebMCP support. Tools operate on the current page's in-memory study, and mutations require expected_revision to protect against stale edits.

ToolPurpose
get_study_specRead the current specification and revision
update_design_elementUpdate a window
add_design_elementAdd a window
remove_design_elementRemove a window
reorder_design_elementsReorder timeline rows
update_study_detailsUpdate study-level metadata
import_study_specReplace the current specification
clear_study_specStart a blank design
validate_study_specRead completeness checks and review items
export_schematicReturn SVG without triggering a download

Unknown dates are represented by null; unresolved text stays blank. Source notes should distinguish documented evidence from researcher-defined choices.

Source layout

  • components/study/: editor, timeline, and information panels
  • components/ui/: reusable interface components
  • lib/study/: schema, validation, timeline layout, export, and WebMCP tools
  • app/globals.css: application styling
  • public/: PDF font and its license
  • vendor/: vendored stylesheet and its license

Licensing and contact

The original canvas application, native WebMCP integration, and remote MCP bridge are licensed under the Apache License 2.0. Copyright 2026 Black Swan Causal Labs, LLC. See NOTICE.

Third-party components retain their own licenses; see THIRD_PARTY_NOTICES.txt, public/DejaVu-font-license.txt, and vendor/shadcn-tailwind-4.13.0.LICENSE.md. The software license does not change rights in user-provided study content or third-party reference material, or grant trademark rights. License and notice files are also distributed with the deployed app.

Black Swan Causal Labs: https://blackswancausallabs.com · [email protected]

Source: README.md at commit 16b760c

Tools

0
This server asks for a credential such as an API key, so SourceWeft could not read its tools without one and has not indexed them.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Diagram integrations

Diagram

la.diagramOfficial publisher

Saves diagrams drawn by the assistant and returns a shareable link that stays current as the diagram is edited.

Streamable HTTPWeb executableAuth
Productivity & WorkflowCredential requiredOct 24, 2026

Zovo Venn

Published by GitHub account theluckystrike

Compares 2 or 3 lists and draws a Venn diagram, returning region tables, counts and SVG, PDF or CSV downloads.

Streamable HTTPWeb executable
Data & Analytics2 toolsNov 8, 2026

Zovo Use Case Diagram

Published by GitHub account theluckystrike

Draws UML use case diagrams from a short line-based grammar, with PDF, SVG and CSV downloads, and checks the diagram text for problems.

Streamable HTTPWeb executable
Developer Tools2 toolsNov 8, 2026

Zovo State Diagram

Published by GitHub account theluckystrike

Draws UML state machine diagrams from a short line grammar and checks the machine for unreachable states, dead ends and duplicate transitions.

Streamable HTTPWeb executable
Developer Tools2 toolsNov 8, 2026

Zovo Sequence Diagram

Published by GitHub account theluckystrike

Turns a short line-based grammar into a UML sequence diagram and returns PDF, SVG and CSV downloads, or checks the text without drawing.

Streamable HTTPWeb executable
Developer Tools2 toolsNov 8, 2026