MCP server for Hypothesis Canvas - Interactive canvas creation and editing through LLM interfaces
npm install hypothesis-canvas-mcpMCP (Model Context Protocol) server for Hypothesis Canvas - Interactive canvas creation and editing through LLM interfaces. This server allows AI assistants to create and retrieve shareable snapshots of various canvas types through the Hypothesis Canvas web application.
- Create shareable canvas snapshots with custom URLs
- Support for all canvas types (Business Model, Opportunity, Hypothesis)
- Optional password protection and expiration settings
- Retrieve shared canvas content via share ID
- No authentication required - works with public API
``bash`
npx hypothesis-canvas-mcp
`bash`
npm install -g hypothesis-canvas-mcp
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json
Windows:
`json`
{
"mcpServers": {
"hypothesis-canvas": {
"command": "npx",
"args": ["hypothesis-canvas-mcp"],
"env": {
"CANVAS_API_URL": "https://hypothesis-canvas-llm-webapp.vercel.app"
}
}
}
}
``
Create a hypothesis canvas snapshot with the following:
- Title: "AI Code Review Assistant"
- Description: "Automated code review using LLMs"
- Cells:
- value-proposition: "Reduce code review time by 80%"
- customer-segments: "Development teams at tech companies"
- key-metrics: "Review time, Bug detection rate"
- channels: "VS Code marketplace, GitHub integration"
- revenue-streams: "Subscription model"
The server will return a shareable URL like:
https://hypothesis-canvas-llm-webapp.vercel.app/share/abc123def
``
Create a business model canvas with password protection:
- Title: "Confidential Business Plan"
- Canvas Type: business
- Password: "secure123"
- Expires in: 24 hours
- Max views: 10
- Cells: [your canvas content...]
``
Get the canvas snapshot with share ID: abc123def
If password protected:
``
Get the canvas snapshot with share ID: abc123def and password: secure123
Creates a shareable snapshot of a canvas.
Parameters:
- canvasType (required): 'business', 'opportunity', or 'hypothesis'title
- (required): Title for the snapshotdescription
- (optional): Additional descriptioncells
- (required): Array of cell objects with:id
- : Cell identifier (e.g., "value-proposition", "customer-segments")content
- : Cell content textshareSettings
- (optional):isPublic
- : Make snapshot publicly accessible (default: true)password
- : Password protect the snapshotexpiresIn
- : Expiration time in hoursmaxViews
- : Maximum number of views allowed
Retrieves a canvas snapshot by share ID.
Parameters:
- shareId (required): The unique share IDpassword
- (optional): Password if the snapshot is protected
- purpose
- vision
- means
- advantage
- metrics
- valueProposition
- obviousProblem
- latentProblem
- alternatives
- situation
- channel
- trend
- revenueModel
- marketSize
- value-propositions
- customer-segments
- channels
- customer-relationships
- revenue-streams
- key-resources
- key-activities
- key-partnerships
- cost-structure
- problems
- solution-ideas
- users-customers
- user-outcomes
- user-benefits
- adoption-strategy
- business-benefits
- business-metrics
- budget-resources
`bashRun in development mode
pnpm dev
Environment Variables
-
CANVAS_API_URL`: The URL of the canvas webapp API (defaults to https://hypothesis-canvas-llm-webapp.vercel.app)