How do I install Study Design Diagram Studio WebMCP?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Study Design Diagram Studio WebMCP need an API key?

No required environment variable is listed on this record.

What transport does Study Design Diagram Studio WebMCP use?

Study Design Diagram Studio WebMCP is reached over HTTP.

When was Study Design Diagram Studio WebMCP last checked?

Last checked 2026-11-08. Read and edit a live study design canvas through its predefined WebMCP tools.

Study Design Diagram Studio WebMCP MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://sdds-webmcp-bridge.jdiazdecaro.workers.dev/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http io.github.black-swan-causal-labs-sdds-webmcp https://sdds-webmcp-bridge.jdiazdecaro.workers.dev/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.black-swan-causal-labs-sdds-webmcp": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://sdds-webmcp-bridge.jdiazdecaro.workers.dev/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.0.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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:

Connection	Requirements	Setup
Native WebMCP	A WebMCP-capable browser and agent	Open the studio and let the agent discover the page's tools
Remote MCP bridge	A Streamable HTTP MCP client that supports custom authorization headers	Enable a temporary connection in the studio and configure the client with its URL and key

For a remote MCP client:

Open Study Design Diagram Studio, select Connect MCP, then Enable connection.
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.
Keep the tab open. Ask the agent to read the current study specification before editing; mutations require its latest revision.
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.

Setting	Value
Custom domain	`sdds.blackswancausallabs.com`
Pages hostname	`sdds-1wj.pages.dev`
Wrangler configuration	`wrangler.json`
DNS record	CNAME `sdds` → `sdds-1wj.pages.dev`

From a checkout with access to the Cloudflare account:

npm ci
npx wrangler login
npm run build
npx 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.

Tool	Purpose
`get_study_spec`	Read the current specification and revision
`update_design_element`	Update a window
`add_design_element`	Add a window
`remove_design_element`	Remove a window
`reorder_design_elements`	Reorder timeline rows
`update_study_details`	Update study-level metadata
`import_study_spec`	Replace the current specification
`clear_study_spec`	Start a blank design
`validate_study_spec`	Read completeness checks and review items
`export_schematic`	Return 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

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]

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Study Design Diagram Studio WebMCP?

Does Study Design Diagram Studio WebMCP need an API key?

What transport does Study Design Diagram Studio WebMCP use?

When was Study Design Diagram Studio WebMCP last checked?

Documentation

Study Design Diagram Studio

Features

Connect an AI agent

Local development

Cloudflare deployment

WebMCP tool reference

Source layout

Licensing and contact